Declarative third party identity provider integration for a multi-tenant identity cloud service

ABSTRACT

Embodiments provide login functionality to a user using a third party identity provider for a multi-tenant identity cloud service. Embodiments receive declarative metadata that includes an identity of a token endpoint corresponding to the third party identity provider and corresponding parameter values. Embodiments store the declarative metadata in a database and receive a request for a login using the third party identity provider. Embodiments retrieve the metadata and build an authorization request and send the authorization request to the third party identity provider, and in response receive an authorization code. Embodiments retrieve the metadata and build a token request using the authorization code and send the token request to the third party identity provider, and in response receive an access token.

CROSS REFERENCE TO RELATED APPLICATIONS

This application claims priority of U.S. Provisional Patent ApplicationSer. No. 62/689,369, filed on Jun. 25, 2018, the disclosure of which ishereby incorporated by reference.

FIELD

One embodiment is directed generally to identity management, and inparticular, to identity management in a cloud system.

BACKGROUND INFORMATION

Generally, the use of cloud-based applications (e.g., enterprise publiccloud applications, third-party cloud applications, etc.) is soaring,with access coming from a variety of devices (e.g., desktop and mobiledevices) and a variety of users (e.g., employees, partners, customers,etc.). The abundant diversity and accessibility of cloud-basedapplications has led identity management and access security to become acentral concern. Typical security concerns in a cloud environment areunauthorized access, account hijacking, malicious insiders, etc.Accordingly, there is a need for secure access to cloud-basedapplications, or applications located anywhere, regardless of from whatdevice type or by what user type the applications are accessed.

SUMMARY

Embodiments provide login functionality to a user using a third partyidentity provider for a multi-tenant identity cloud service. Embodimentsreceive declarative metadata that includes an identity of a tokenendpoint corresponding to the third party identity provider andcorresponding parameter values. Embodiments store the declarativemetadata in a database and receive a request for a login using the thirdparty identity provider. Embodiments retrieve the metadata and build anauthorization request and send the authorization request to the thirdparty identity provider, and in response receive an authorization code.Embodiments retrieve the metadata and build a token request using theauthorization code and send the token request to the third partyidentity provider, and in response receive an access token.

BRIEF DESCRIPTION OF THE DRAWINGS

FIGS. 1-5 are block diagrams of example embodiments that providecloud-based identity management.

FIG. 6 is a block diagram providing a system view of an embodiment.

FIG. 6A is a block diagram providing a functional view of an embodiment.

FIG. 7 is a block diagram of an embodiment that implements Cloud Gate.

FIG. 8 illustrates an example system that implements multiple tenanciesin one embodiment.

FIG. 9 is a block diagram of a network view of an embodiment.

FIG. 10 is a block diagram of a system architecture view of single signon (“SSO”) functionality in one embodiment.

FIG. 11 is a message sequence flow of SSO functionality in oneembodiment.

FIG. 12 illustrates an example of a distributed data grid in oneembodiment.

FIG. 13 illustrates a sequence diagram in accordance with embodiments ofthe invention.

DETAILED DESCRIPTION

Embodiments provide a declarative framework that allows metadata to bedefined so that a 3^(rd) party identity provider can be provisioned andused as a login mechanism for a multi-tenant identity cloud service. Themetadata can be generated by a user with special privileges, andprevents the requirement of software coding to be generated and storedwhen a new 3^(rd) party identity provider is desired to be added.

Embodiments provide an identity cloud service that implements amicroservices based architecture and provides multi-tenant identity anddata security management and secure access to cloud-based applications.Embodiments support secure access for hybrid cloud deployments (i.e.,cloud deployments which include a combination of a public cloud and aprivate cloud). Embodiments protect applications and data both in thecloud and on-premise. Embodiments support multi-channel access via web,mobile, and application programming interfaces (“APIs”). Embodimentsmanage access for different users, such as customers, partners, andemployees. Embodiments manage, control, and audit access across thecloud as well as on-premise. Embodiments integrate with new and existingapplications and identities. Embodiments are horizontally scalable.

One embodiment is a system that implements a number of microservices ina stateless middle tier environment to provide cloud-based multi-tenantidentity and access management services. In one embodiment, eachrequested identity management service is broken into real-time andnear-real-time tasks. The real-time tasks are handled by a microservicein the middle tier, while the near-real-time tasks are offloaded to amessage queue. Embodiments implement access tokens that are consumed bya routing tier and a middle tier to enforce a security model foraccessing the microservices. Accordingly, embodiments provide acloud-scale Identity and Access Management (“IAM”) platform based on amulti-tenant, microservices architecture.

One embodiment provides an identity cloud service that enablesorganizations to rapidly develop fast, reliable, and secure services fortheir new business initiatives. In one embodiment, the identity cloudservice provides a number of core services, each of which solving aunique challenge faced by many enterprises. In one embodiment, theidentity cloud service supports administrators in, for example, initialon-boarding/importing of users, importing groups with user members,creating/updating/disabling/enabling/deleting users,assigning/un-assigning users into/from groups,creating/updating/deleting groups, resetting passwords, managingpolicies, sending activation, etc. The identity cloud service alsosupports end users in, for example, modifying profiles, settingprimary/recovery emails, verifying emails, unlocking their accounts,changing passwords, recovering passwords in case of forgotten password,etc.

Unified Security of Access

One embodiment protects applications and data in a cloud environment aswell as in an on-premise environment. The embodiment secures access toany application from any device by anyone. The embodiment providesprotection across both environments since inconsistencies in securitybetween the two environments may result in higher risks. For example,such inconsistencies may cause a sales person to continue having accessto their Customer Relationship Management (“CRM”) account even afterthey have defected to the competition. Accordingly, embodiments extendthe security controls provisioned in the on-premise environment into thecloud environment. For example, if a person leaves a company,embodiments ensure that their accounts are disabled both on-premise andin the cloud.

Generally, users may access applications and/or data through manydifferent channels such as web browsers, desktops, mobile phones,tablets, smart watches, other wearables, etc. Accordingly, oneembodiment provides secured access across all these channels. Forexample, a user may use their mobile phone to complete a transactionthey started on their desktop.

One embodiment further manages access for various users such ascustomers, partners, employees, etc. Generally, applications and/or datamay be accessed not just by employees but by customers or third parties.Although many known systems take security measures when onboardingemployees, they generally do not take the same level of securitymeasures when giving access to customers, third parties, partners, etc.,resulting in the possibility of security breaches by parties that arenot properly managed. However, embodiments ensure that sufficientsecurity measures are provided for access of each type of user and notjust employees.

Identity Cloud Service

Embodiments provide an Identity Cloud Service (“IDCS”) that is amulti-tenant, cloud-scale, IAM platform. IDCS provides authentication,authorization, auditing, and federation. IDCS manages access to customapplications and services running on the public cloud, and on-premisesystems. In an alternative or additional embodiment, IDCS may alsomanage access to public cloud services. For example, IDCS can be used toprovide Single Sign On (“SSO”) functionality across such variety ofservices/applications/systems.

Embodiments are based on a multi-tenant, microservices architecture fordesigning, building, and delivering cloud-scale software services.Multi-tenancy refers to having one physical implementation of a servicesecurely supporting multiple customers buying that service. A service isa software functionality or a set of software functionalities (such asthe retrieval of specified information or the execution of a set ofoperations) that can be reused by different clients for differentpurposes, together with the policies that control its usage (e.g., basedon the identity of the client requesting the service). In oneembodiment, a service is a mechanism to enable access to one or morecapabilities, where the access is provided using a prescribed interfaceand is exercised consistent with constraints and policies as specifiedby the service description.

In one embodiment, a microservice is an independently deployableservice. In one embodiment, the term microservice contemplates asoftware architecture design pattern in which complex applications arecomposed of small, independent processes communicating with each otherusing language-agnostic APIs. In one embodiment, microservices aresmall, highly decoupled services and each may focus on doing a smalltask. In one embodiment, the microservice architectural style is anapproach to developing a single application as a suite of smallservices, each running in its own process and communicating withlightweight mechanisms (e.g., an HTTP resource API). In one embodiment,microservices are easier to replace relative to a monolithic servicethat performs all or many of the same functions. Moreover, each of themicroservices may be updated without adversely affecting the othermicroservices. In contrast, updates to one portion of a monolithicservice may undesirably or unintentionally negatively affect the otherportions of the monolithic service. In one embodiment, microservices maybe beneficially organized around their capabilities. In one embodiment,the startup time for each of a collection of microservices is much lessthan the startup time for a single application that collectivelyperforms all the services of those microservices. In some embodiments,the startup time for each of such microservices is about one second orless, while the startup time of such single application may be about aminute, several minutes, or longer.

In one embodiment, microservices architecture refers to a specialization(i.e., separation of tasks within a system) and implementation approachfor service oriented architectures (“SOAs”) to build flexible,independently deployable software systems. Services in a microservicesarchitecture are processes that communicate with each other over anetwork in order to fulfill a goal. In one embodiment, these servicesuse technology-agnostic protocols. In one embodiment, the services havea small granularity and use lightweight protocols. In one embodiment,the services are independently deployable. By distributingfunctionalities of a system into different small services, the cohesionof the system is enhanced and the coupling of the system is decreased.This makes it easier to change the system and add functions andqualities to the system at any time. It also allows the architecture ofan individual service to emerge through continuous refactoring, andhence reduces the need for a big up-front design and allows forreleasing software early and continuously.

In one embodiment, in the microservices architecture, an application isdeveloped as a collection of services, and each service runs arespective process and uses a lightweight protocol to communicate (e.g.,a unique API for each microservice). In the microservices architecture,decomposition of a software into individual services/capabilities can beperformed at different levels of granularity depending on the service tobe provided. A service is a runtime component/process. Each microserviceis a self-contained module that can talk to other modules/microservices.Each microservice has an unnamed universal port that can be contacted byothers. In one embodiment, the unnamed universal port of a microserviceis a standard communication channel that the microservice exposes byconvention (e.g., as a conventional Hypertext Transfer Protocol (“HTTP”)port) and that allows any other module/microservice within the sameservice to talk to it. A microservice or any other self-containedfunctional module can be generically referred to as a “service”.

Embodiments provide multi-tenant identity management services.Embodiments are based on open standards to ensure ease of integrationwith various applications, delivering IAM capabilities throughstandards-based services.

Embodiments manage the lifecycle of user identities which entails thedetermination and enforcement of what an identity can access, who can begiven such access, who can manage such access, etc. Embodiments run theidentity management workload in the cloud and support securityfunctionality for applications that are not necessarily in the cloud.The identity management services provided by the embodiments may bepurchased from the cloud. For example, an enterprise may purchase suchservices from the cloud to manage their employees' access to theirapplications.

Embodiments provide system security, massive scalability, end userusability, and application interoperability. Embodiments address thegrowth of the cloud and the use of identity services by customers. Themicroservices based foundation addresses horizontal scalabilityrequirements, while careful orchestration of the services addresses thefunctional requirements. Achieving both goals requires decomposition(wherever possible) of the business logic to achieve statelessness witheventual consistency, while much of the operational logic not subject toreal-time processing is shifted to near-real-time by offloading to ahighly scalable asynchronous event management system with guaranteeddelivery and processing. Embodiments are fully multi-tenant from the webtier to the data tier in order to realize cost efficiencies and ease ofsystem administration.

Embodiments are based on industry standards (e.g., OpenID Connect,OAuth2, Security Assertion Markup Language 2 (“SAML2”), System forCross-domain Identity Management (“SCIM”), Representational StateTransfer (“REST”), etc.) for ease of integration with variousapplications. One embodiment provides a cloud-scale API platform andimplements horizontally scalable microservices for elastic scalability.The embodiment leverages cloud principles and provides a multi-tenantarchitecture with per-tenant data separation. The embodiment furtherprovides per-tenant customization via tenant self-service. Theembodiment is available via APIs for on-demand integration with otheridentity services, and provides continuous feature release.

One embodiment provides interoperability and leverages investments inidentity management (“IDM”) functionality in the cloud and on-premise.The embodiment provides automated identity synchronization fromon-premise Lightweight Directory Access Protocol (“LDAP”) data to clouddata and vice versa. The embodiment provides a SCIM identity bus betweenthe cloud and the enterprise, and allows for different options forhybrid cloud deployments (e.g., identity federation and/orsynchronization, SSO agents, user provisioning connectors, etc.).

Accordingly, one embodiment is a system that implements a number ofmicroservices in a stateless middle tier to provide cloud-basedmulti-tenant identity and access management services. In one embodiment,each requested identity management service is broken into real-time andnear-real-time tasks. The real-time tasks are handled by a microservicein the middle tier, while the near-real-time tasks are offloaded to amessage queue. Embodiments implement tokens that are consumed by arouting tier to enforce a security model for accessing themicroservices. Accordingly, embodiments provide a cloud-scale IAMplatform based on a multi-tenant, microservices architecture.

Generally, known systems provide siloed access to applications providedby different environments, e.g., enterprise cloud applications, partnercloud applications, third-party cloud applications, and customerapplications. Such siloed access may require multiple passwords,different password policies, different account provisioning andde-provisioning schemes, disparate audit, etc. However, one embodimentimplements IDCS to provide unified IAM functionality over suchapplications. FIG. 1 is a block diagram 100 of an example embodimentwith IDCS 118, providing a unified identity platform 126 for onboardingusers and applications. The embodiment provides seamless user experienceacross various applications such as enterprise cloud applications 102,partner cloud applications 104, third-party cloud applications 110, andcustomer applications 112. Applications 102, 104, 110, 112 may beaccessed through different channels, for example, by a mobile phone user108 via a mobile phone 106, by a desktop computer user 116 via a browser114, etc. A web browser (commonly referred to as a browser) is asoftware application for retrieving, presenting, and traversinginformation resources on the World Wide Web. Examples of web browsersare Mozilla Firefox®, Google Chrome®, Microsoft Internet Explorer®, andApple Safari®.

IDCS 118 provides a unified view 124 of a user's applications, a unifiedsecure credential across devices and applications (via identity platform126), and a unified way of administration (via an admin console 122).IDCS services may be obtained by calling IDCS APIs 142. Such servicesmay include, for example, login/SSO services 128 (e.g., OpenID Connect),federation services 130 (e.g., SAML), token services 132 (e.g., OAuth),directory services 134 (e.g., SCIM), provisioning services 136 (e.g.,SCIM or Any Transport over Multiprotocol (“AToM”)), event services 138(e.g., REST), and authorization services 140 (e.g., SCIM). IDCS 118 mayfurther provide reports and dashboards 120 related to the offeredservices.

Integration Tools

Generally, it is common for large corporations to have an IAM system inplace to secure access to their on-premise applications. Businesspractices are usually matured and standardized around an in-house IAMsystem such as “Oracle IAM Suite” from Oracle Corp. Even small to mediumorganizations usually have their business processes designed aroundmanaging user access through a simple directory solution such asMicrosoft Active Directory (“AD”). To enable on-premise integration,embodiments provide tools that allow customers to integrate theirapplications with IDCS.

FIG. 2 is a block diagram 200 of an example embodiment with IDCS 202 ina cloud environment 208, providing integration with an AD 204 that ison-premise 206. The embodiment provides seamless user experience acrossall applications including on-premise and third-party applications, forexample, on-premise applications 218 and various applications/servicesin cloud 208 such as cloud services 210, cloud applications 212, partnerapplications 214, and customer applications 216. Cloud applications 212may include, for example, Human Capital Management (“HCM”), CRM, talentacquisition (e.g., Oracle Taleo cloud service from Oracle Corp.),Configure Price and Quote (“CPQ”), etc. Cloud services 210 may include,for example, Platform as a Service (“PaaS”), Java, database, businessintelligence (“BI”), documents, etc.

Applications 210, 212, 214, 216, 218, may be accessed through differentchannels, for example, by a mobile phone user 220 via a mobile phone222, by a desktop computer user 224 via a browser 226, etc. Theembodiment provides automated identity synchronization from on-premiseAD data to cloud data via a SCIM identity bus 234 between cloud 208 andthe enterprise 206. The embodiment further provides a SAML bus 228 forfederating authentication from cloud 208 to on-premise AD 204 (e.g.,using passwords 232).

Generally, an identity bus is a service bus for identity relatedservices. A service bus provides a platform for communicating messagesfrom one system to another system. It is a controlled mechanism forexchanging information between trusted systems, for example, in aservice oriented architecture (“SOA”). An identity bus is a logical busbuilt according to standard HTTP based mechanisms such as web service,web server proxies, etc. The communication in an identity bus may beperformed according to a respective protocol (e.g., SCIM, SAML, OpenIDConnect, etc.). For example, a SAML bus is an HTTP based connectionbetween two systems for communicating messages for SAML services.Similarly, a SCIM bus is used to communicate SCIM messages according tothe SCIM protocol.

The embodiment of FIG. 2 implements an identity (“ID”) bridge 230 thatis a small binary (e.g., 1 MB in size) that can be downloaded andinstalled on-premise 206 alongside a customer's AD 204. ID Bridge 230listens to users and groups (e.g., groups of users) from theorganizational units (“OUs”) chosen by the customer and synchronizesthose users to cloud 208. In one embodiment, users' passwords 232 arenot synchronized to cloud 208. Customers can manage application accessfor users by mapping IDCS users' groups to cloud applications managed inIDCS 208. Whenever the users' group membership is changed on-premise206, their corresponding cloud application access changes automatically.

For example, an employee moving from engineering to sales can get nearinstantaneous access to the sales cloud and lose access to the developercloud. When this change is reflected in on-premise AD 204, cloudapplication access change is accomplished in near-real-time. Similarly,access to cloud applications managed in IDCS 208 is revoked for usersleaving the company. For full automation, customers may set up SSObetween on-premise AD 204 and IDCS 208 through, e.g., AD federationservice (“AD/FS”, or some other mechanism that implements SAMLfederation) so that end users can get access to cloud applications 210,212, 214, 216, and on-premise applications 218 with a single corporatepassword 332.

FIG. 3 is a block diagram 300 of an example embodiment that includes thesame components 202, 206, 208, 210, 212, 214, 216, 218, 220, 222, 224,226, 228, 234 as in FIG. 2. However, in the embodiment of FIG. 3, IDCS202 provides integration with an on-premise IDM 304 such as Oracle IDM.Oracle IDM 304 is a software suite from Oracle Corp. for providing IAMfunctionality. The embodiment provides seamless user experience acrossall applications including on-premise and third-party applications. Theembodiment provisions user identities from on-premise IDM 304 to IDCS208 via SCIM identity bus 234 between cloud 202 and enterprise 206. Theembodiment further provides SAML bus 228 (or an OpenID Connect bus) forfederating authentication from cloud 208 to on-premise 206.

In the embodiment of FIG. 3, an Oracle Identity Manager (“OIM”)Connector 302 from Oracle Corp., and an Oracle Access Manager (“OAM”)federation module 306 from Oracle Corp., are implemented as extensionmodules of Oracle IDM 304. A connector is a module that has physicalawareness about how to talk to a system. OIM is an applicationconfigured to manage user identities (e.g., manage user accounts indifferent systems based on what a user should and should not have accessto). OAM is a security application that provides access managementfunctionality such as web SSO; identity context, authentication andauthorization; policy administration; testing; logging; auditing; etc.OAM has built-in support for SAML. If a user has an account in IDCS 202,OIM connector 302 and OAM federation 306 can be used with Oracle IDM 304to create/delete that account and manage access from that account.

FIG. 4 is a block diagram 400 of an example embodiment that includes thesame components 202, 206, 208, 210, 212, 214, 216, 218, 220, 222, 224,226, 234 as in FIGS. 2 and 3. However, in the embodiment of FIG. 3, IDCS202 provides functionality to extend cloud identities to on-premiseapplications 218. The embodiment provides seamless view of the identityacross all applications including on-premise and third-partyapplications. In the embodiment of FIG. 4, SCIM identity bus 234 is usedto synchronize data in IDCS 202 with on-premise LDAP data called “CloudCache” 402. Cloud Cache 402 is disclosed in more detail below.

Generally, an application that is configured to communicate based onLDAP needs an LDAP connection. An LDAP connection may not be establishedby such application through a URL (unlike, e.g., “www.google.com” thatmakes a connection to Google) since the LDAP needs to be on a localnetwork. In the embodiment of FIG. 4, an LDAP-based application 218makes a connection to Cloud Cache 402, and Cloud Cache 402 establishes aconnection to IDCS 202 and then pulls data from IDCS 202 as it is beingrequested. The communication between IDCS 202 and Cloud Cache 402 may beimplemented according to the SCIM protocol. For example, Cloud Cache 402may use SCIM bus 234 to send a SCIM request to IDCS 202 and receivecorresponding data in return.

Generally, fully implementing an application includes building aconsumer portal, running marketing campaigns on the external userpopulation, supporting web and mobile channels, and dealing with userauthentication, sessions, user profiles, user groups, application roles,password policies, self-service/registration, social integration,identity federation, etc. Generally, application developers are notidentity/security experts. Therefore, on-demand identity managementservices are desired.

FIG. 5 is a block diagram 500 of an example embodiment that includes thesame components 202, 220, 222, 224, 226, 234, 402, as in FIGS. 2-4.However, in the embodiment of FIG. 5, IDCS 202 provides secure identitymanagement on demand. The embodiment provides on demand integration withidentity services of IDCS 202 (e.g., based on standards such as OpenIDConnect, OAuth2, SAML2, or SCIM). Applications 505 (which may beon-premise, in a public cloud, or in a private cloud) may call identityservice APIs 504 in IDCS 202. The services provided by IDCS 202 mayinclude, for example, self-service registration 506, password management508, user profile management 510, user authentication 512, tokenmanagement 514, social integration 516, etc.

In this embodiment, SCIM identity bus 234 is used to synchronize data inIDCS 202 with data in on-premise LDAP Cloud Cache 402. Further, a “CloudGate” 502 running on a web server/proxy (e.g., NGINX, Apache, etc.) maybe used by applications 505 to obtain user web SSO and REST API securityfrom IDCS 202. Cloud Gate 502 is a component that secures access tomulti-tenant IDCS microservices by ensuring that client applicationsprovide valid access tokens, and/or users successfully authenticate inorder to establish SSO sessions. Cloud Gate 502 is further disclosedbelow. Cloud Gate 502 (enforcement point similar to webgate/webagent)enables applications running behind supported web servers to participatein SSO.

One embodiment provides SSO and cloud SSO functionality. A general pointof entry for both on-premise IAM and IDCS in many organizations is SSO.Cloud SSO enables users to access multiple cloud resources with a singleuser sign-in. Often, organizations will want to federate theiron-premise identities. Accordingly, embodiments utilize open standardsto allow for integration with existing SSO to preserve and extendinvestment (e.g., until a complete, eventual transition to an identitycloud service approach is made).

One embodiment may provide the following functionalities:

maintain an identity store to track user accounts, ownership, access,and permissions that have been authorized,

integrate with workflow to facilitate various approvals (e.g.,management, IT, human resources, legal, and compliance) needed forapplications access,

provision SaaS user accounts for selective devices (e.g., mobile andpersonal computer (“PC”)) with access to user portal containing manyprivate and public cloud resources, and

facilitate periodic management attestation review for compliance withregulations and current job responsibilities.

In addition to these functions, embodiments may further provide:

cloud account provisioning to manage account life cycle in cloudapplications,

more robust multifactor authentication (“MFA”) integration,

extensive mobile security capabilities, and

dynamic authentication options.

One embodiment provides adaptive authentication and MFA. Generally,passwords and challenge questions have been seen as inadequate andsusceptible to common attacks such as phishing. Most business entitiestoday are looking at some form of MFA to reduce risk. To be successfullydeployed, however, solutions need to be easily provisioned, maintained,and understood by the end user, as end users usually resist anythingthat interferes with their digital experience. Companies are looking forways to securely incorporate bring your own device (“BYOD”), socialidentities, remote users, customers, and contractors, while making MFAan almost transparent component of a seamless user access experience.Within an MFA deployment, industry standards such as OAuth and OpenIDConnect are essential to ensure integration of existing multifactorsolutions and the incorporation of newer, adaptive authenticationtechnology. Accordingly, embodiments define dynamic (or adaptive)authentication as the evaluation of available information (i.e., IPaddress, location, time of day, and biometrics) to prove an identityafter a user session has been initiated. With the appropriate standards(e.g., open authentication (“OATH”) and fast identity online (“FIDO”))integration and extensible identity management framework, embodimentsprovide MFA solutions that can be adopted, upgraded, and integratedeasily within an IT organization as part of an end-to-end secure IAMdeployment. When considering MFA and adaptive policies, organizationsmust implement consistent policies across on-premise and cloudresources, which in a hybrid IDCS and on-premise IAM environmentrequires integration between systems.

One embodiment provides user provisioning and certification. Generally,the fundamental function of an IAM solution is to enable and support theentire user provisioning life cycle. This includes providing users withthe application access appropriate for their identity and role withinthe organization, certifying that they have the correct ongoing accesspermissions (e.g., as their role or the tasks or applications usedwithin their role change over time), and promptly de-provisioning themas their departure from the organization may require. This is importantnot only for meeting various compliance requirements but also becauseinappropriate insider access is a major source of security breaches andattacks. An automated user provisioning capability within an identitycloud solution can be important not only in its own right but also aspart of a hybrid IAM solution whereby IDCS provisioning may providegreater flexibility than an on-premise solution for transitions as acompany downsizes, upsizes, merges, or looks to integrate existingsystems with IaaS/PaaS/SaaS environments. An IDCS approach can save timeand effort in one-off upgrades and ensure appropriate integration amongnecessary departments, divisions, and systems. The need to scale thistechnology often sneaks up on corporations, and the ability to deliver ascalable IDCS capability immediately across the enterprise can providebenefits in flexibility, cost, and control.

Generally, an employee is granted additional privileges (i.e.,“privilege creep”) over the years as her/his job changes. Companies thatare lightly regulated generally lack an “attestation” process thatrequires managers to regularly audit their employees' privileges (e.g.,access to networks, servers, applications, and data) to halt or slow theprivilege creep that results in over-privileged accounts. Accordingly,one embodiment may provide a regularly conducted (at least once a year)attestation process. Further, with mergers and acquisitions, the needfor these tools and services increases exponentially as users are onSaaS systems, on-premise, span different departments, and/or are beingde-provisioned or re-allocated. The move to cloud can further complicatethis situation, and the process can quickly escalate beyond existing,often manually managed, certification methods. Accordingly, oneembodiment automates these functions and applies sophisticated analyticsto user profiles, access history, provisioning/de-provisioning, andfine-grained entitlements.

One embodiment provides identity analytics. Generally, the ability tointegrate identity analytics with the IAM engine for comprehensivecertification and attestation can be critical to securing anorganization's risk profile. Properly deployed identity analytics candemand total internal policy enforcement. Identity analytics thatprovide a unified single management view across cloud and on-premise aremuch needed in a proactive governance, risk, and compliance (“GRC”)enterprise environment, and can aid in providing a closed-loop processfor reducing risk and meeting compliance regulations. Accordingly, oneembodiment provides identity analytics that are easily customizable bythe client to accommodate specific industry demands and governmentregulations for reports and analysis required by managers, executives,and auditors.

One embodiment provides self-service and access request functionality toimprove the experience and efficiency of the end user and to reducecosts from help desk calls. Generally, while a number of companiesdeploy on-premise self-service access request for their employees, manyhave not extended these systems adequately outside the formal corporatewalls. Beyond employee use, a positive digital customer experienceincreases business credibility and ultimately contributes to revenueincrease, and companies not only save on customer help desk calls andcosts but also improve customer satisfaction. Accordingly, oneembodiment provides an identity cloud service environment that is basedon open standards and seamlessly integrates with existing access controlsoftware and MFA mechanisms when necessary. The SaaS delivery modelsaves time and effort formerly devoted to systems upgrades andmaintenance, freeing professional IT staff to focus on more corebusiness applications.

One embodiment provides privileged account management (“PAM”).Generally, every organization, whether using SaaS, PaaS, IaaS, oron-premise applications, is vulnerable to unauthorized privilegedaccount abuse by insiders with super-user access credentials such assystem administrators, executives, HR officers, contractors, systemsintegrators, etc. Moreover, outside threats typically first breach alow-level user account to eventually reach and exploit privileged useraccess controls within the enterprise system. Accordingly, oneembodiment provides PAM to prevent such unauthorized insider accountuse. The main component of a PAM solution is a password vault which maybe delivered in various ways, e.g., as software to be installed on anenterprise server, as a virtual appliance also on an enterprise server,as a packaged hardware/software appliance, or as part of a cloudservice. PAM functionality is similar to a physical safe used to storepasswords kept in an envelope and changed periodically, with a manifestfor signing them in and out. One embodiment allows for a passwordcheckout as well as setting time limits, forcing periodic changes,automatically tracking checkout, and reporting on all activities. Oneembodiment provides a way to connect directly through to a requestedresource without the user ever knowing the password. This capabilityalso paves the way for session management and additional functionality.

Generally, most cloud services utilize APIs and administrativeinterfaces, which provide opportunities for infiltrators to circumventsecurity. Accordingly, one embodiment accounts for these holes in PAMpractices as the move to the cloud presents new challenges for PAM. Manysmall to medium sized businesses now administer their own SaaS systems(e.g., Office 365), while larger companies increasingly have individualbusiness units spinning up their own SaaS and IaaS services. Thesecustomers find themselves with PAM capabilities within the identitycloud service solutions or from their IaaS/PaaS provider but with littleexperience in handling this responsibility. Moreover, in some cases,many different geographically dispersed business units are trying tosegregate administrative responsibilities for the same SaaSapplications. Accordingly, one embodiment allows customers in thesesituations to link existing PAM into the overall identity framework ofthe identity cloud service and move toward greater security andcompliance with the assurance of scaling to cloud load requirements asbusiness needs dictate.

API Platform

Embodiments provide an API platform that exposes a collection ofcapabilities as services. The APIs are aggregated into microservices andeach microservice exposes one or more of the APIs. That is, eachmicroservice may expose different types of APIs. In one embodiment, eachmicroservice communicates only through its APIs. In one embodiment, eachAPI may be a microservice. In one embodiment, multiple APIs areaggregated into a service based on a target capability to be provided bythat service (e.g., OAuth, SAML, Admin, etc.). As a result, similar APIsare not exposed as separate runtime processes. The APIs are what is madeavailable to a service consumer to use the services provided by IDCS.

Generally, in the web environment of IDCS, a URL includes three parts: ahost, a microservice, and a resource (e.g., host/microservice/resource).In one embodiment, the microservice is characterized by having aspecific URL prefix, e.g., “host/oauth/v1” where the actual microserviceis “oauth/v1”, and under “oauth/v1” there are multiple APIs, e.g., anAPI to request tokens: “host/oauth/v1/token”, an API to authenticate auser: “host/oauth/v1/authorize”, etc. That is, the URL implements amicroservice, and the resource portion of the URL implements an API.Accordingly, multiple APIs are aggregated under the same microservice.In one embodiment, the host portion of the URL identifies a tenant(e.g., https://tenant3.identity.oraclecloud.com:/oauth/v1/token”).

Configuring applications that integrate with external services with thenecessary endpoints and keeping that configuration up to date istypically a challenge. To meet this challenge, embodiments expose apublic discovery API at a well-known location from where applicationscan discover the information about IDCS they need in order to consumeIDCS APIs. In one embodiment, two discovery documents are supported:IDCS Configuration (which includes IDCS, SAML, SCIM, OAuth, and OpenIDConnect configuration, at e.g.,<IDCS-URL>/.well-known/idcs-configuration), and Industry-standard OpenIDConnect Configuration (at, e.g.,<IDCS-URL>/.well-known/openid-configuration). Applications can retrievediscovery documents by being configured with a single IDCS URL.

FIG. 6 is a block diagram providing a system view 600 of IDCS in oneembodiment. In FIG. 6, any one of a variety of applications/services 602may make HTTP calls to IDCS APIs to use IDCS services. Examples of suchapplications/services 602 are web applications, native applications(e.g., applications that are built to run on a specific operatingsystem, such as Windows applications, iOS applications, Androidapplications, etc.), web services, customer applications, partnerapplications, or any services provided by a public cloud, such asSoftware as a Service (“SaaS”), PaaS, and Infrastructure as a Service(“IaaS”).

In one embodiment, the HTTP requests of applications/services 602 thatrequire IDCS services go through an Oracle Public Cloud BIG-IP appliance604 and an IDCS BIG-IP appliance 606 (or similar technologies such as aLoad Balancer, or a component called a Cloud Load Balancer as a Service(“LBaaS”) that implements appropriate security rules to protect thetraffic). However, the requests can be received in any manner. At IDCSBIG-IP appliance 606 (or, as applicable, a similar technology such as aLoad Balancer or a Cloud LBaaS), a cloud provisioning engine 608performs tenant and service orchestration. In one embodiment, cloudprovisioning engine 608 manages internal security artifacts associatedwith a new tenant being on-boarded into the cloud or a new serviceinstance purchased by a customer.

The HTTP requests are then received by an IDCS web routing tier 610 thatimplements a security gate (i.e., Cloud Gate) and provides servicerouting and microservices registration and discovery 612. Depending onthe service requested, the HTTP request is forwarded to an IDCSmicroservice in the IDCS middle tier 614. IDCS microservices processexternal and internal HTTP requests. IDCS microservices implementplatform services and infrastructure services. IDCS platform servicesare separately deployed Java-based runtime services implementing thebusiness of IDCS. IDCS infrastructure services are separately deployedruntime services providing infrastructure support for IDCS. IDCS furtherincludes infrastructure libraries that are common code packaged asshared libraries used by IDCS services and shared libraries.Infrastructure services and libraries provide supporting capabilities asrequired by platform services for implementing their functionality.

Platform Services

In one embodiment, IDCS supports standard authentication protocols,hence IDCS microservices include platform services such as OpenIDConnect, OAuth, SAML2, System for Cross-domain Identity Management++(“SCIM++”), etc.

The OpenID Connect platform service implements standard OpenID ConnectLogin/Logout flows. Interactive web-based and native applicationsleverage standard browser-based OpenID Connect flow to request userauthentication, receiving standard identity tokens that are JavaScriptObject Notation (“JSON”) Web Tokens (“JWTs”) conveying the user'sauthenticated identity. Internally, the runtime authentication model isstateless, maintaining the user's authentication/session state in theform of a host HTTP cookie (including the JWT identity token). Theauthentication interaction initiated via the OpenID Connect protocol isdelegated to a trusted SSO service that implements the user login/logoutceremonies for local and federated logins. Further details of thisfunctionality are disclosed below with reference to FIGS. 10 and 11. Inone embodiment, OpenID Connect functionality is implemented accordingto, for example, OpenID Foundation standards.

The OAuth2 platform service provides token authorization services. Itprovides a rich API infrastructure for creating and validating accesstokens conveying user rights to make API calls. It supports a range ofuseful token grant types, enabling customers to securely connect clientsto their services. It implements standard 2-legged and 3-legged OAuth2token grant types. Support for OpenID Connect (“OIDC”) enables compliantapplications (OIDC relaying parties (“RP”s)) to integrate with IDCS asthe identity provider (OIDC OpenID provider (“OP”)). Similarly, theintegration of IDCS as OIDC RP with social OIDC OP (e.g., Facebook,Google, etc.) enables customers to allow social identities policy-basedaccess to applications. In one embodiment, OAuth functionality isimplemented according to, for example, Internet Engineering Task Force(“IETF”), Request for Comments (“RFC”) 6749.

The SAML2 platform service provides identity federation services. Itenables customers to set up federation agreements with their partnersbased on SAML identity provider (“IDP”) and SAML service provider (“SP”)relationship models. In one embodiment, the SAML2 platform serviceimplements standard SAML2 Browser POST Login and Logout Profiles. In oneembodiment, SAML functionality is implemented according to, for example,IETF, RFC 7522.

SCIM is an open standard for automating the exchange of user identityinformation between identity domains or information technology (“IT”)systems, as provided by, e.g., IETF, RFCs 7642, 7643, 7644. The SCIM++platform service provides identity administration services and enablescustomers to access IDP features of IDCS. The administration servicesexpose a set of stateless REST interfaces (i.e., APIs) that coveridentity lifecycle, password management, group management, etc.,exposing such artifacts as web-accessible resources.

All IDCS configuration artifacts are resources, and the APIs of theadministration services allow for managing IDCS resources (e.g., users,roles, password policies, applications, SAML/OIDC identity providers,SAML service providers, keys, certifications, notification templates,etc.). Administration services leverage and extend the SCIM standard toimplement schema-based REST APIs for Create, Read, Update, Delete, andQuery (“CRUDQ”) operations on all IDCS resources. Additionally, allinternal resources of IDCS used for administration and configuration ofIDCS itself are exposed as SCIM-based REST APIs. Access to the identitystore 618 is isolated to the SCIM++ API.

In one embodiment, for example, the SCIM standard is implemented tomanage the users and groups resources as defined by the SCIMspecifications, while SCIM++ is configured to support additional IDCSinternal resources (e.g., password policies, roles, settings, etc.)using the language defined by the SCIM standard.

The Administration service supports the SCIM 2.0 standard endpoints withthe standard SCIM 2.0 core schemas and schema extensions where needed.In addition, the Administration service supports several SCIM 2.0compliant endpoint extensions to manage other IDCS resources, forexample, Users, Groups, Applications, Settings, etc. The Administrationservice also supports a set of remote procedure call-style (“RPC-style”)REST interfaces that do not perform CRUDQ operations but instead providea functional service, for example, “UserPasswordGenerator,”“UserPasswordValidator,” etc.

IDCS Administration APIs use the OAuth2 protocol for authentication andauthorization. IDCS supports common OAuth2 scenarios such as scenariosfor web server, mobile, and JavaScript applications. Access to IDCS APIsis protected by access tokens. To access IDCS Administration APIs, anapplication needs to be registered as an OAuth2 client or an IDCSApplication (in which case the OAuth2 client is created automatically)through the IDCS Administration console and be granted desired IDCSAdministration Roles. When making IDCS Administration API calls, theapplication first requests an access token from the IDCS OAuth2 Service.After acquiring the token, the application sends the access token to theIDCS API by including it in the HTTP authorization header. Applicationscan use IDCS Administration REST APIs directly, or use an IDCS JavaClient API Library.

Infrastructure Services

The IDCS infrastructure services support the functionality of IDCSplatform services. These runtime services include an event processingservice (for asynchronously processing user notifications, applicationsubscriptions, and auditing to database); a job scheduler service (forscheduling and executing jobs, e.g., executing immediately or at aconfigured time long-running tasks that do not require userintervention); a cache management service; a storage management service(for integrating with a public cloud storage service); a reports service(for generating reports and dashboards); an SSO service (for managinginternal user authentication and SSO); a user interface (“UI”) service(for hosting different types of UI clients); and a service managerservice. Service manager is an internal interface between the OraclePublic Cloud and IDCS. Service manager manages commands issued by theOracle Public Cloud, where the commands need to be implemented by IDCS.For example, when a customer signs up for an account in a cloud storebefore they can buy something, the cloud sends a request to IDCS askingto create a tenant. In this case, service manager implements the cloudspecific operations that the cloud expects IDCS to support.

An IDCS microservice may call another IDCS microservice through anetwork interface (i.e., an HTTP request).

In one embodiment, IDCS may also provide a schema service (or apersistence service) that allows for using a database schema. A schemaservice allows for delegating the responsibility of managing databaseschemas to IDCS. Accordingly, a user of IDCS does not need to manage adatabase since there is an IDCS service that provides thatfunctionality. For example, the user may use the database to persistschemas on a per tenant basis, and when there is no more space in thedatabase, the schema service will manage the functionality of obtaininganother database and growing the space so that the users do not have tomanage the database themselves.

IDCS further includes data stores which are data repositoriesrequired/generated by IDCS, including an identity store 618 (storingusers, groups, etc.), a global database 620 (storing configuration dataused by IDCS to configure itself), an operational schema 622 (providingper tenant schema separation and storing customer data on a per customerbasis), an audit schema 624 (storing audit data), a caching cluster 626(storing cached objects to speed up performance), etc. All internal andexternal IDCS consumers integrate with the identity services overstandards-based protocols. This enables use of a domain name system(“DNS”) to resolve where to route requests, and decouples consumingapplications from understanding the internal implementation of identityservices.

Real-Time and Near-Real-Time Tasks

IDCS separates the tasks of a requested service into synchronousreal-time and asynchronous near-real-time tasks, where real-time tasksinclude only the operations that are needed for the user to proceed. Inone embodiment, a real-time task is a task that is performed withminimal delay, and a near-real-time task is a task that is performed inthe background without the user having to wait for it. In oneembodiment, a real-time task is a task that is performed withsubstantially no delay or with negligible delay, and appears to a useras being performed almost instantaneously.

The real-time tasks perform the main business functionality of aspecific identity service. For example, when requesting a login service,an application sends a message to authenticate a user's credentials andget a session cookie in return. What the user experiences is logginginto the system. However, several other tasks may be performed inconnection with the user's logging in, such as validating who the useris, auditing, sending notifications, etc. Accordingly, validating thecredentials is a task that is performed in real-time so that the user isgiven an HTTP cookie to start a session, but the tasks related tonotifications (e.g., sending an email to notify the creation of anaccount), audits (e.g., tracking/recording), etc., are near-real-timetasks that can be performed asynchronously so that the user can proceedwith least delay.

When an HTTP request for a microservice is received, the correspondingreal-time tasks are performed by the microservice in the middle tier,and the remaining near-real-time tasks such as operational logic/eventsthat are not necessarily subject to real-time processing are offloadedto message queues 628 that support a highly scalable asynchronous eventmanagement system 630 with guaranteed delivery and processing.Accordingly, certain behaviors are pushed from the front end to thebackend to enable IDCS to provide high level service to the customers byreducing latencies in response times. For example, a login process mayinclude validation of credentials, submission of a log report, updatingof the last login time, etc., but these tasks can be offloaded to amessage queue and performed in near-real-time as opposed to real-time.

In one example, a system may need to register or create a new user. Thesystem calls an IDCS SCIM API to create a user. The end result is thatwhen the user is created in identity store 618, the user gets anotification email including a link to reset their password. When IDCSreceives a request to register or create a new user, the correspondingmicroservice looks at configuration data in the operational database(located in global database 620 in FIG. 6) and determines that the“create user” operation is marked with a “create user” event which isidentified in the configuration data as an asynchronous operation. Themicroservice returns to the client and indicates that the creation ofthe user is done successfully, but the actual sending of thenotification email is postponed and pushed to the backend. In order todo so, the microservice uses a messaging API 616 to queue the message inqueue 628 which is a store.

In order to dequeue queue 628, a messaging microservice, which is aninfrastructure microservice, continually runs in the background andscans queue 628 looking for events in queue 628. The events in queue 628are processed by event subscribers 630 such as audit, user notification,application subscriptions, data analytics, etc. Depending on the taskindicated by an event, event subscribers 630 may communicate with, forexample, audit schema 624, a user notification service 634, an identityevent subscriber 632, etc. For example, when the messaging microservicefinds the “create user” event in queue 628, it executes thecorresponding notification logic and sends the corresponding email tothe user.

In one embodiment, queue 628 queues operational events published bymicroservices 614 as well as resource events published by APIs 616 thatmanage IDCS resources.

IDCS uses a real-time caching structure to enhance system performanceand user experience. The cache itself may also be provided as amicroservice. IDCS implements an elastic cache cluster 626 that grows asthe number of customers supported by IDCS scales. Cache cluster 626 maybe implemented with a distributed data grid which is disclosed in moredetail below. In one embodiment, write-only resources bypass cache.

In one embodiment, IDCS runtime components publish health andoperational metrics to a public cloud monitoring module 636 thatcollects such metrics of a public cloud such as Oracle Public Cloud fromOracle Corp.

In one embodiment, IDCS may be used to create a user. For example, aclient application 602 may issue a REST API call to create a user. Adminservice (a platform service in 614) delegates the call to a user manager(an infrastructure library/service in 614), which in turn creates theuser in the tenant-specific ID store stripe in ID store 618. On “UserCreate Success”, the user manager audits the operation to the audittable in audit schema 624, and publishes an“identity.user.create.success” event to message queue 628. Identitysubscriber 632 picks up the event and sends a “Welcome” email to thenewly created user, including newly created login details.

In one embodiment, IDCS may be used to grant a role to a user, resultingin a user provisioning action. For example, a client application 602 mayissue a REST API call to grant a user a role. Admin service (a platformservice in 614) delegates the call to a role manager (an infrastructurelibrary/service in 614), who grants the user a role in thetenant-specific ID store stripe in ID store 618. On “Role GrantSuccess”, the role manager audits the operations to the audit table inaudit schema 624, and publishes an “identity.user.role.grant.success”event to message queue 628. Identity subscriber 632 picks up the eventand evaluates the provisioning grant policy. If there is an activeapplication grant on the role being granted, a provisioning subscriberperforms some validation, initiates account creation, calls out thetarget system, creates an account on the target system, and marks theaccount creation as successful. Each of these functionalities may resultin publishing of corresponding events, such as“prov.account.create.initiate”, “prov.target.create.initiate”,“prov.target.create.success”, or “prov.account.create.success”. Theseevents may have their own business metrics aggregating number ofaccounts created in the target system over the last N days.

In one embodiment, IDCS may be used for a user to log in. For example, aclient application 602 may use one of the supported authentication flowsto request a login for a user. IDCS authenticates the user, and uponsuccess, audits the operation to the audit table in audit schema 624.Upon failure, IDCS audits the failure in audit schema 624, and publishes“login.user.login.failure” event in message queue 628. A loginsubscriber picks up the event, updates its metrics for the user, anddetermines if additional analytics on the user's access history need tobe performed.

Accordingly, by implementing “inversion of control” functionality (e.g.,changing the flow of execution to schedule the execution of an operationat a later time so that the operation is under the control of anothersystem), embodiments enable additional event queues and subscribers tobe added dynamically to test new features on a small user sample beforedeploying to broader user base, or to process specific events forspecific internal or external customers.

Stateless Functionality

IDCS microservices are stateless, meaning the microservices themselvesdo not maintain state. “State” refers to the data that an applicationuses in order to perform its capabilities. IDCS provides multi-tenantfunctionality by persisting all state into tenant specific repositoriesin the IDCS data tier. The middle tier (i.e., the code that processesthe requests) does not have data stored in the same location as theapplication code. Accordingly, IDCS is highly scalable, bothhorizontally and vertically.

To scale vertically (or scale up/down) means to add resources to (orremove resources from) a single node in a system, typically involvingthe addition of CPUs or memory to a single computer. Verticalscalability allows an application to scale up to the limits of itshardware. To scale horizontally (or scale out/in) means to add morenodes to (or remove nodes from) a system, such as adding a new computerto a distributed software application. Horizontal scalability allows anapplication to scale almost infinitely, bound only by the amount ofbandwidth provided by the network.

Stateless-ness of the middle tier of IDCS makes it horizontally scalablejust by adding more CPUs, and the IDCS components that perform the workof the application do not need to have a designated physicalinfrastructure where a particular application is running. Stateless-nessof the IDCS middle tier makes IDCS highly available, even when providingidentity services to a very large number of customers/tenants. Each passthrough an IDCS application/service is focused on CPU usage only toperform the application transaction itself but not use hardware to storedata. Scaling is accomplished by adding more slices when the applicationis running, while data for the transaction is stored at a persistencelayer where more copies can be added when needed.

The IDCS web tier, middle tier, and data tier can each scaleindependently and separately. The web tier can be scaled to handle moreHTTP requests. The middle tier can be scaled to support more servicefunctionality. The data tier can be scaled to support more tenants.

IDCS Functional View

FIG. 6A is an example block diagram 600 b of a functional view of IDCSin one embodiment. In block diagram 600 b, the IDCS functional stackincludes services, shared libraries, and data stores. The servicesinclude IDCS platform services 640 b, IDCS premium services 650 b, andIDCS infrastructure services 662 b. In one embodiment, IDCS platformservices 640 b and IDCS premium services 650 b are separately deployedJava-based runtime services implementing the business of IDCS, and IDCSinfrastructure services 662 b are separately deployed runtime servicesproviding infrastructure support for IDCS. The shared libraries includeIDCS infrastructure libraries 680 b which are common code packaged asshared libraries used by IDCS services and shared libraries. The datastores are data repositories required/generated by IDCS, includingidentity store 698 b, global configuration 700 b, message store 702 b,global tenant 704 b, personalization settings 706 b, resources 708 b,user transient data 710 b, system transient data 712 b, per-tenantschemas (managed ExaData) 714 b, operational store (not shown), cachingstore (not shown), etc.

In one embodiment, IDCS platform services 640 b include, for example,OpenID Connect service 642 b, OAuth2 service 644 b, SAML2 service 646 b,and SCIM++ service 648 b. In one embodiment, IDCS premium servicesinclude, for example, cloud SSO and governance 652 b, enterprisegovernance 654 b, AuthN broker 656 b, federation broker 658 b, andprivate account management 660 b.

IDCS infrastructure services 662 b and IDCS infrastructure libraries 680b provide supporting capabilities as required by IDCS platform services640 b to do their work. In one embodiment, IDCS infrastructure services662 b include job scheduler 664 b, UI 666 b, SSO 668 b, reports 670 b,cache 672 b, storage 674 b, service manager 676 b (public cloudcontrol), and event processor 678 b (user notifications, appsubscriptions, auditing, data analytics). In one embodiment, IDCSinfrastructure libraries 680 b include data manager APIs 682 b, eventAPIs 684 b, storage APIs 686 b, authentication APIs 688 b, authorizationAPIs 690 b, cookie APIs 692 b, keys APIs 694 b, and credentials APIs 696b. In one embodiment, cloud compute service 602 b (internal Nimbula)supports the function of IDCS infrastructure services 662 b and IDCSinfrastructure libraries 680 b.

In one embodiment, IDCS provides various UIs 602 b for a consumer ofIDCS services, such as customer end user UI 604 b, customer admin UI 606b, DevOps admin UI 608 b, and login UI 610 b. In one embodiment, IDCSallows for integration 612 b of applications (e.g., customer apps 614 b,partner apps 616 b, and cloud apps 618 b) and firmware integration 620b. In one embodiment, various environments may integrate with IDCS tosupport their access control needs. Such integration may be provided by,for example, identity bridge 622 b (providing AD integration, WNA, andSCIM connector), Apache agent 624 b, or MSFT agent 626 b.

In one embodiment, internal and external IDCS consumers integrate withthe identity services of IDCS over standards-based protocols 628 b, suchas OpenID Connect 630 b, OAuth2 632 b, SAML2 634 b, SCIM 636 b, andREST/HTTP 638 b. This enables use of a domain name system (“DNS”) toresolve where to route requests, and decouples the consumingapplications from understanding internal implementation of the identityservices.

The IDCS functional view in FIG. 6A further includes public cloudinfrastructure services that provide common functionality that IDCSdepends on for user notifications (cloud notification service 718 b),file storage (cloud storage service 716 b), and metrics/alerting forDevOps (cloud monitoring service (EM) 722 b and cloud metrics service(Graphite) 720 b).

Cloud Gate

In one embodiment, IDCS implements a “Cloud Gate” in the web tier. CloudGate is a web server plugin that enables web applications to externalizeuser SSO to an identity management system (e.g., IDCS), similar toWebGate or WebAgent technologies that work with enterprise IDM stacks.Cloud Gate acts as a security gatekeeper that secures access to IDCSAPIs. In one embodiment, Cloud Gate is implemented by a web/proxy serverplugin that provides a web Policy Enforcement Point (“PEP”) forprotecting HTTP resources based on OAuth.

FIG. 7 is a block diagram 700 of an embodiment that implements a CloudGate 702 running in a web server 712 and acting as a Policy EnforcementPoint (“PEP”) configured to integrate with IDCS Policy Decision Point(“PDP”) using open standards (e.g., OAuth2, OpenID Connect, etc.) whilesecuring access to web browser and REST API resources 714 of anapplication. In some embodiments, the PDP is implemented at OAuth and/orOpenID Connect microservices 704. For example, when a user browser 706sends a request to IDCS for a login of a user 710, a corresponding IDCSPDP validates the credentials and then decides whether the credentialsare sufficient (e.g., whether to request for further credentials such asa second password). In the embodiment of FIG. 7, Cloud Gate 702 may actboth as the PEP and as the PDP since it has a local policy.

As part of one-time deployment, Cloud Gate 702 is registered with IDCSas an OAuth2 client, enabling it to request OIDC and OAuth2 operationsagainst IDCS. Thereafter, it maintains configuration information aboutan application's protected and unprotected resources, subject to requestmatching rules (how to match URLs, e.g., with wild cards, regularexpressions, etc.). Cloud Gate 702 can be deployed to protect differentapplications having different security policies, and the protectedapplications can be multi-tenant.

During web browser-based user access, Cloud Gate 702 acts as an OIDC RP718 initiating a user authentication flow. If user 710 has no validlocal user session, Cloud Gate 702 re-directs the user to the SSOmicroservice and participates in the OIDC “Authorization Code” flow withthe SSO microservice. The flow concludes with the delivery of a JWT asan identity token. Cloud Gate 708 validates the JWT (e.g., looks atsignature, expiration, destination/audience, etc.) and issues a localsession cookie for user 710. It acts as a session manager 716 securingweb browser access to protected resources and issuing, updating, andvalidating the local session cookie. It also provides a logout URL forremoval of its local session cookie.

Cloud Gate 702 also acts as an HTTP Basic Auth authenticator, validatingHTTP Basic Auth credentials against IDCS. This behavior is supported inboth session-less and session-based (local session cookie) modes. Noserver-side IDCS session is created in this case.

During programmatic access by REST API clients 708, Cloud Gate 702 mayact as an OAuth2 resource server/filter 720 for an application'sprotected REST APIs 714. It checks for the presence of a request with anauthorization header and an access token. When client 708 (e.g., mobile,web apps, JavaScript, etc.) presents an access token (issued by IDCS) touse with a protected REST API 714, Cloud Gate 702 validates the accesstoken before allowing access to the API (e.g., signature, expiration,audience, etc.). The original access token is passed along unmodified.

Generally, OAuth is used to generate either a client identitypropagation token (e.g., indicating who the client is) or a useridentity propagation token (e.g., indicating who the user is). In theembodiments, the implementation of OAuth in Cloud Gate is based on a JWTwhich defines a format for web tokens, as provided by, e.g., IETF, RFC7519.

When a user logs in, a JWT is issued. The JWT is signed by IDCS andsupports multi-tenant functionality in IDCS. Cloud Gate validates theJWT issued by IDCS to allow for multi-tenant functionality in IDCS.Accordingly, IDCS provides multi-tenancy in the physical structure aswell as in the logical business process that underpins the securitymodel.

Tenancy Types

IDCS specifies three types of tenancies: customer tenancy, clienttenancy, and user tenancy. Customer or resource tenancy specifies whothe customer of IDCS is (i.e., for whom is the work being performed).Client tenancy specifies which client application is trying to accessdata (i.e., what application is doing the work). User tenancy specifieswhich user is using the application to access data (i.e., by whom is thework being performed). For example, when a professional services companyprovides system integration functionality for a warehouse club and usesIDCS for providing identity management for the warehouse club systems,user tenancy corresponds to the professional services company, clienttenancy is the application that is used to provide system integrationfunctionality, and customer tenancy is the warehouse club.

Separation and identification of these three tenancies enablesmulti-tenant functionality in a cloud-based service. Generally, foron-premise software that is installed on a physical machine on-premise,there is no need to specify three different tenancies since a user needsto be physically on the machine to log in. However, in a cloud-basedservice structure, embodiments use tokens to determine who is using whatapplication to access which resources. The three tenancies are codifiedby tokens, enforced by Cloud Gate, and used by the business services inthe middle tier. In one embodiment, an OAuth server generates thetokens. In various embodiments, the tokens may be used in conjunctionwith any security protocol other than OAuth.

Decoupling user, client, and resource tenancies provides substantialbusiness advantages for the users of the services provided by IDCS. Forexample, it allows a service provider that understands the needs of abusiness (e.g., a healthcare business) and their identity managementproblems to buy services provided by IDCS, develop their own backendapplication that consumes the services of IDCS, and provide the backendapplications to the target businesses. Accordingly, the service providermay extend the services of IDCS to provide their desired capabilitiesand offer those to certain target businesses. The service provider doesnot have to build and run software to provide identity services but caninstead extend and customize the services of IDCS to suit the needs ofthe target businesses.

Some known systems only account for a single tenancy which is customertenancy. However, such systems are inadequate when dealing with accessby a combination of users such as customer users, customer's partners,customer's clients, clients themselves, or clients that customer hasdelegated access to. Defining and enforcing multiple tenancies in theembodiments facilitates the identity management functionality over suchvariety of users.

In one embodiment, one entity of IDCS does not belong to multipletenants at the same time; it belongs to only one tenant, and a “tenancy”is where artifacts live. Generally, there are multiple components thatimplement certain functions, and these components can belong to tenantsor they can belong to infrastructure. When infrastructure needs to acton behalf of tenants, it interacts with an entity service on behalf ofthe tenant. In that case, infrastructure itself has its own tenancy andcustomer has its own tenancy. When a request is submitted, there can bemultiple tenancies involved in the request.

For example, a client that belongs to “tenant 1” may execute a requestto get a token for “tenant 2” specifying a user in “tenant 3.” Asanother example, a user living in “tenant 1” may need to perform anaction in an application owned by “tenant 2”. Thus, the user needs to goto the resource namespace of “tenant 2” and request a token forthemselves. Accordingly, delegation of authority is accomplished byidentifying “who” can do “what” to “whom.” As yet another example, afirst user working for a first organization (“tenant 1”) may allow asecond user working for a second organization (“tenant 2”) to haveaccess to a document hosted by a third organization (“tenant 3”).

In one example, a client in “tenant 1” may request an access token for auser in “tenant 2” to access an application in “tenant 3”. The clientmay do so by invoking an OAuth request for the token by going to“http://tenant3/oauth/token”. The client identifies itself as a clientthat lives in “tenant 1” by including a “client assertion” in therequest. The client assertion includes a client ID (e.g., “client 1”)and the client tenancy “tenant 1”. As “client 1” in “tenant 1”, theclient has the right to invoke a request for a token on “tenant 3”, andthe client wants the token for a user in “tenant 2”. Accordingly, a“user assertion” is also passed as part of the same HTTP request. Theaccess token that is generated will be issued in the context of thetarget tenancy which is the application tenancy (“tenant 3”) and willinclude the user tenancy (“tenant 2”).

In one embodiment, in the data tier, each tenant is implemented as aseparate stripe. From a data management perspective, artifacts live in atenant. From a service perspective, a service knows how to work withdifferent tenants, and the multiple tenancies are different dimensionsin the business function of a service. FIG. 8 illustrates an examplesystem 800 implementing multiple tenancies in an embodiment. System 800includes a client 802 that requests a service provided by a microservice804 that understands how to work with data in a database 806. Thedatabase includes multiple tenants 808 and each tenant includes theartifacts of the corresponding tenancy. In one embodiment, microservice804 is an OAuth microservice requested throughhttps://tenant3/oauth/token for getting a token. The function of theOAuth microservice is performed in microservice 804 using data fromdatabase 806 to verify that the request of client 802 is legitimate, andif it is legitimate, use the data from different tenancies 808 toconstruct the token. Accordingly, system 800 is multi-tenant in that itcan work in a cross-tenant environment by not only supporting servicescoming into each tenancy, but also supporting services that can act onbehalf of different tenants.

System 800 is advantageous since microservice 804 is physicallydecoupled from the data in database 806, and by replicating the dataacross locations that are closer to the client, microservice 804 can beprovided as a local service to the clients and system 800 can manage theavailability of the service and provide it globally.

In one embodiment, microservice 804 is stateless, meaning that themachine that runs microservice 804 does not maintain any markerspointing the service to any specific tenants. Instead, a tenancy may bemarked, for example, on the host portion of a URL of a request thatcomes in. That tenancy points to one of tenants 808 in database 806.When supporting a large number of tenants (e.g., millions of tenants),microservice 804 cannot have the same number of connections to database806, but instead uses a connection pool 810 which provides the actualphysical connections to database 806 in the context of a database user.

Generally, connections are built by supplying an underlying driver orprovider with a connection string, which is used to address a specificdatabase or server and to provide instance and user authenticationcredentials (e.g., “Server=sql_box;Database=Common;UserID=uid;Pwd=password;”). Once a connection has been built, it can beopened and closed, and properties (e.g., the command time-out length, ortransaction, if one exists) can be set. The connection string includes aset of key-value pairs, dictated by the data access interface of thedata provider. A connection pool is a cache of database connectionsmaintained so that the connections can be reused when future requests toa database are required. In connection pooling, after a connection iscreated, it is placed in the pool and it is used again so that a newconnection does not have to be established. For example, when thereneeds to be ten connections between microservice 804 and database 808,there will be ten open connections in connection pool 810, all in thecontext of a database user (e.g., in association with a specificdatabase user, e.g., who is the owner of that connection, whosecredentials are being validated, is it a database user, is it a systemcredential, etc.).

The connections in connection pool 810 are created for a system userthat can access anything. Therefore, in order to correctly handleauditing and privileges by microservice 804 processing requests onbehalf of a tenant, the database operation is performed in the contextof a “proxy user” 812 associated with the schema owner assigned to thespecific tenant. This schema owner can access only the tenancy that theschema was created for, and the value of the tenancy is the value of theschema owner. When a request is made for data in database 806,microservice 804 uses the connections in connection pool 810 to providethat data. Accordingly, multi-tenancy is achieved by having stateless,elastic middle tier services process incoming requests in the context of(e.g., in association with) the tenant-specific data store bindingestablished on a per request basis on top of the data connection createdin the context of (e.g., in association with) the data store proxy userassociated with the resource tenancy, and the database can scaleindependently of the services.

The following provides an example functionality for implementing proxyuser 812:

dbOperation=<prepare DB command to execute>

dbConnection=getDBConnectionFromPool( )

dbConnection.setProxyUser (resourceTenant)

result=dbConnection.executeOperation (dbOperation)

In this functionality, microservice 804 sets the “Proxy User” setting onthe connection pulled from connection pool 810 to the “Tenant,” andperforms the database operation in the context of the tenant while usingthe database connection in connection pool 810.

When striping every table to configure different columns in a samedatabase for different tenants, one table may include all tenants' datamixed together. In contrast, one embodiment provides a tenant-drivendata tier. The embodiment does not stripe the same database fordifferent tenants, but instead provides a different physical databaseper tenant. For example, multi-tenancy may be implemented by using apluggable database (e.g., Oracle Database 12c from Oracle Corp.) whereeach tenant is allocated a separate partition. At the data tier, aresource manager processes the request and then asks for the data sourcefor the request (separate from metadata). The embodiment performsruntime switch to a respective data source/store per request. Byisolating each tenant's data from the other tenants, the embodimentprovides improved data security.

In one embodiment, various tokens codify different tenancies. A URLtoken may identify the tenancy of the application that requests aservice. An identity token may codify the identity of a user that is tobe authenticated. An access token may identify multiple tenancies. Forexample, an access token may codify the tenancy that is the target ofsuch access (e.g., an application tenancy) as well as the user tenancyof the user that is given access. A client assertion token may identifya client ID and the client tenancy. A user-assertion token may identifythe user and the user tenancy.

In one embodiment, an identity token includes at least a claim/statementindicating the user tenant name (i.e., where the user lives). A “claim”(as used by one of ordinary skill in the security field) in connectionwith authorization tokens is a statement that one subject makes aboutitself or another subject. The statement can be about a name, identity,key, group, privilege, or capability, for example. Claims are issued bya provider, and they are given one or more values and then packaged insecurity tokens that are issued by an issuer, commonly known as asecurity token service (“STS”).

In one embodiment, an access token includes at least a claim/statementindicating the resource tenant name at the time the request for theaccess token was made (e.g., the customer), a claim indicating the usertenant name, a claim indicating the name of the OAuth client making therequest, and a claim indicating the client tenant name. In oneembodiment, an access token may be implemented according to thefollowing JSON functionality:

{  ...  ″ tok_type ″ : ″AT″,  ″user_id″ : ″testuser″,  ″user_tenantname″: ″<value-of-identity-tenant>″  “tenant” : “<value-of-resource-tenant>” “client_id” : “testclient”,  “client_tenantname”:“<value-of-client-tenant>”  ... }

In one embodiment, a client assertion token includes at least a claimindicating the client tenant name, and a claim indicating the name ofthe OAuth client making the request.

The tokens and/or multiple tenancies described herein may be implementedin any multi-tenant cloud-based service other than IDCS. For example,the tokens and/or multiple tenancies described herein may be implementedin SaaS or Enterprise Resource Planning (“ERP”) services.

FIG. 9 is a block diagram of a network view 900 of IDCS in oneembodiment. FIG. 9 illustrates network interactions that are performedin one embodiment between application “zones” 904. Applications arebroken into zones based on the required level of protection and theimplementation of connections to various other systems (e.g., SSL zone,no SSL zone, etc.). Some application zones provide services that requireaccess from the inside of IDCS, while some application zones provideservices that require access from the outside of IDCS, and some are openaccess. Accordingly, a respective level of protection is enforced foreach zone.

In the embodiment of FIG. 9, service to service communication isperformed using HTTP requests. In one embodiment, IDCS uses the accesstokens described herein not only to provide services but also to secureaccess to and within IDCS itself. In one embodiment, IDCS microservicesare exposed through RESTful interfaces and secured by the tokensdescribed herein.

In the embodiment of FIG. 9, any one of a variety ofapplications/services 902 may make HTTP calls to IDCS APIs to use IDCSservices. In one embodiment, the HTTP requests of applications/services902 go through an Oracle Public Cloud Load Balancing External Virtual IPaddress (“VIP”) 906 (or other similar technologies), a public cloud webrouting tier 908, and an IDCS Load Balancing Internal VIP appliance 910(or other similar technologies), to be received by IDCS web routing tier912. IDCS web routing tier 912 receives the requests coming in from theoutside or from the inside of IDCS and routes them across either an IDCSplatform services tier 914 or an IDCS infrastructure services tier 916.IDCS platform services tier 914 includes IDCS microservices that areinvoked from the outside of IDCS, such as OpenID Connect, OAuth, SAML,SCIM, etc. IDCS infrastructure services tier 916 includes supportingmicroservices that are invoked from the inside of IDCS to support thefunctionality of other IDCS microservices. Examples of IDCSinfrastructure microservices are UI, SSO, reports, cache, job scheduler,service manager, functionality for making keys, etc. An IDCS cache tier926 supports caching functionality for IDCS platform services tier 914and IDCS infrastructure services tier 916.

By enforcing security both for outside access to IDCS and within IDCS,customers of IDCS can be provided with outstanding security compliancefor the applications they run.

In the embodiment of FIG. 9, other than the data tier 918 whichcommunicates based on Structured Query Language (“SQL”) and the ID storetier 920 that communicates based on LDAP, OAuth protocol is used toprotect the communication among IDCS components (e.g., microservices)within IDCS, and the same tokens that are used for securing access fromthe outside of IDCS are also used for security within IDCS. That is, webrouting tier 912 uses the same tokens and protocols for processing therequests it receives regardless of whether a request is received fromthe outside of IDCS or from the inside of IDCS. Accordingly, IDCSprovides a single consistent security model for protecting the entiresystem, thereby allowing for outstanding security compliance since thefewer security models implemented in a system, the more secure thesystem is.

In the IDCS cloud environment, applications communicate by makingnetwork calls. The network call may be based on an applicable networkprotocol such as HTTP, Transmission Control Protocol (“TCP”), UserDatagram Protocol (“UDP”), etc. For example, an application “X” maycommunicate with an application “Y” based on HTTP by exposingapplication “Y” as an HTTP Uniform Resource Locator (“URL”). In oneembodiment, “Y” is an IDCS microservice that exposes a number ofresources each corresponding to a capability. When “X” (e.g., anotherIDCS microservice) needs to call “Y”, it constructs a URL that includes“Y” and the resource/capability that needs to be invoked (e.g.,https:/host/Y/resource), and makes a corresponding REST call which goesthrough web routing tier 912 and gets directed to “Y”.

In one embodiment, a caller outside the IDCS may not need to know where“Y” is, but web routing tier 912 needs to know where application “Y” isrunning. In one embodiment, IDCS implements discovery functionality(implemented by an API of OAuth service) to determine where eachapplication is running so that there is no need for the availability ofstatic routing information.

In one embodiment, an enterprise manager (“EM”) 922 provides a “singlepane of glass” that extends on-premise and cloud-based management toIDCS. In one embodiment, a “Chef” server 924 which is a configurationmanagement tool from Chef Software, Inc., provides configurationmanagement functionality for various IDCS tiers. In one embodiment, aservice deployment infrastructure and/or a persistent stored module 928may send OAuth2 HTTP messages to IDCS web routing tier 912 for tenantlifecycle management operations, public cloud lifecycle managementoperations, or other operations. In one embodiment, IDCS infrastructureservices tier 916 may send ID/password HTTP messages to a public cloudnotification service 930 or a public cloud storage service 932.

Cloud Access Control—SSO

One embodiment supports lightweight cloud standards for implementing acloud scale SSO service. Examples of lightweight cloud standards areHTTP, REST, and any standard that provides access through a browser(since a web browser is lightweight). On the contrary, SOAP is anexample of a heavy cloud standard which requires more management,configuration, and tooling to build a client with. The embodiment usesOpenID Connect semantics for applications to request user authenticationagainst IDCS. The embodiment uses lightweight HTTP cookie-based usersession tracking to track user's active sessions at IDCS withoutstateful server-side session support. The embodiment uses JWT-basedidentity tokens for applications to use in mapping an authenticatedidentity back to their own local session. The embodiment supportsintegration with federated identity management systems, and exposes SAMLIDP support for enterprise deployments to request user authenticationagainst IDCS.

FIG. 10 is a block diagram 1000 of a system architecture view of SSOfunctionality in IDCS in one embodiment. The embodiment enables clientapplications to leverage standards-based web protocols to initiate userauthentication flows. Applications requiring SSO integration with acloud system may be located in enterprise data centers, in remotepartner data centers, or even operated by a customer on-premise. In oneembodiment, different IDCS platform services implement the business ofSSO, such as OpenID Connect for processing login/logout requests fromconnected native applications (i.e., applications utilizing OpenIDConnect to integrate with IDCS); SAML IDP service for processingbrowser-based login/logout requests from connected applications; SAML SPservice for orchestrating user authentication against an external SAMLIDP; and an internal IDCS SSO service for orchestrating end user loginceremony including local or federated login flows, and for managing IDCShost session cookie. Generally, HTTP works either with a form or withouta form. When it works with a form, the form is seen within a browser.When it works without a form, it functions as a client to servercommunication. Both OpenID Connect and SAML require the ability torender a form, which may be accomplished by presence of a browser orvirtually performed by an application that acts as if there is abrowser. In one embodiment, an application client implementing userauthentication/SSO through IDCS needs to be registered in IDCS as anOAuth2 client and needs to obtain client identifier and credentials(e.g., ID/password, ID/certificate, etc.).

The example embodiment of FIG. 10 includes threecomponents/microservices that collectively provide login capabilities,including two platform microservices: OAuth2 1004 and SAML2 1006, andone infrastructure microservice: SSO 1008. In the embodiment of FIG. 10,IDCS provides an “Identity Metasystem” in which SSO services 1008 areprovided over different types of applications, such as browser based webor native applications 1010 requiring 3-legged OAuth flow and acting asan OpenID Connect relaying party (“RP,” an application that outsourcesits user authentication function to an IDP), native applications 1011requiring 2-legged OAuth flow and acting as an OpenID Connect RP, andweb applications 1012 acting as a SAML SP.

Generally, an Identity Metasystem is an interoperable architecture fordigital identity, allowing for employing a collection of digitalidentities based on multiple underlying technologies, implementations,and providers. LDAP, SAML, and OAuth are examples of different securitystandards that provide identity capability and can be the basis forbuilding applications, and an Identity Metasystem may be configured toprovide a unified security system over such applications. The LDAPsecurity model specifies a specific mechanism for handling identity, andall passes through the system are to be strictly protected. SAML wasdeveloped to allow one set of applications securely exchange informationwith another set of applications that belong to a different organizationin a different security domain. Since there is no trust between the twoapplications, SAML was developed to allow for one application toauthenticate another application that does not belong to the sameorganization. OAuth provides OpenID Connect that is a lightweightprotocol for performing web based authentication.

In the embodiment of FIG. 10, when an OpenID application 1010 connectsto an OpenID server in IDCS, its “channels” request SSO service.Similarly, when a SAML application 1012 connects to a SAML server inIDCS, its “channels” also request SSO service. In IDCS, a respectivemicroservice (e.g., an OpenID microservice 1004 and a SAML microservice1006) will handle each of the applications, and these microservicesrequest SSO capability from SSO microservice 1008. This architecture canbe expanded to support any number of other security protocols by addinga microservice for each protocol and then using SSO microservice 1008for SSO capability. SSO microservice 1008 issues the sessions (i.e., anSSO cookie 1014 is provided) and is the only system in the architecturethat has the authority to issue a session. An IDCS session is realizedthrough the use of SSO cookie 1014 by browser 1002. Browser 1002 alsouses a local session cookie 1016 to manage its local session.

In one embodiment, for example, within a browser, a user may use a firstapplication based on SAML and get logged in, and later use a secondapplication built with a different protocol such as OAuth. The user isprovided with SSO on the second application within the same browser.Accordingly, the browser is the state or user agent and maintains thecookies.

In one embodiment, SSO microservice 1008 provides login ceremony 1018,ID/password recovery 1020, first time login flow 1022, an authenticationmanager 1024, an HTTP cookie manager 1026, and an event manager 1028.Login ceremony 1018 implements SSO functionality based on customersettings and/or application context, and may be configured according toa local form (i.e., basic Auth), an external SAML IDP, an external OIDCIDP, etc. ID/password recovery 1020 is used to recover a user's IDand/or password. First time login flow 1022 is implemented when a userlogs in for the first time (i.e., an SSO session does not yet exist).Authentication manager 1024 issues authentication tokens upon successfulauthentication. HTTP cookie manager 1026 saves the authentication tokenin an SSO cookie. Event manager 1028 publishes events related to SSOfunctionality.

In one embodiment, interactions between OAuth microservice 1004 and SSOmicroservice 1008 are based on browser redirects so that SSOmicroservice 1008 challenges the user using an HTML form, validatescredentials, and issues a session cookie.

In one embodiment, for example, OAuth microservice 1004 may receive anauthorization request from browser 1002 to authenticate a user of anapplication according to 3-legged OAuth flow. OAuth microservice 1004then acts as an OIDC provider 1030, redirects browser 1002 to SSOmicroservice 1008, and passes along application context. Depending onwhether the user has a valid SSO session or not, SSO microservice 1008either validates the existing session or performs a login ceremony. Uponsuccessful authentication or validation, SSO microservice 1008 returnsauthentication context to OAuth microservice 1004. OAuth microservice1004 then redirects browser 1002 to a callback URL with an authorization(“AZ”) code. Browser 1002 sends the AZ code to OAuth microservice 1004to request the required tokens 1032. Browser 1002 also includes itsclient credentials (obtained when registering in IDCS as an OAuth2client) in the HTTP authorization header. OAuth microservice 1004 inreturn provides the required tokens 1032 to browser 1002. In oneembodiment, tokens 1032 provided to browser 1002 include JW identity andaccess tokens signed by the IDCS OAuth2 server. Further details of thisfunctionality are disclosed below with reference to FIG. 11.

In one embodiment, for example, OAuth microservice 1004 may receive anauthorization request from a native application 1011 to authenticate auser according to a 2-legged OAuth flow. In this case, an authenticationmanager 1034 in OAuth microservice 1004 performs the correspondingauthentication (e.g., based on ID/password received from a client 1011)and a token manager 1036 issues a corresponding access token uponsuccessful authentication.

In one embodiment, for example, SAML microservice 1006 may receive anSSO POST request from a browser to authenticate a user of a webapplication 1012 that acts as a SAML SP. SAML microservice 1006 thenacts as a SAML IDP 1038, redirects browser 1002 to SSO microservice1008, and passes along application context. Depending on whether theuser has a valid SSO session or not, SSO microservice 1008 eithervalidates the existing session or performs a login ceremony. Uponsuccessful authentication or validation, SSO microservice 1008 returnsauthentication context to SAML microservice 1006. SAML microservice thenredirects to the SP with required tokens.

In one embodiment, for example, SAML microservice 1006 may act as a SAMLSP 1040 and go to a remote SAML IDP 1042 (e.g., an active directoryfederation service (“ADFS”)). One embodiment implements the standardSAML/AD flows. In one embodiment, interactions between SAML microservice1006 and SSO microservice 1008 are based on browser redirects so thatSSO microservice 1008 challenges the user using an HTML form, validatescredentials, and issues a session cookie.

In one embodiment, the interactions between a component within IDCS(e.g., 1004, 1006, 1008) and a component outside IDCS (e.g., 1002, 1011,1042) are performed through firewalls 1044.

Login/Logout Flow

FIG. 11 is a message sequence flow 1100 of SSO functionality provided byIDCS in one embodiment. When a user uses a browser 1102 to access aclient 1106 (e.g., a browser-based application or a mobile/nativeapplication), Cloud Gate 1104 acts as an application enforcement pointand enforces a policy defined in a local policy text file. If Cloud Gate1104 detects that the user has no local application session, it requiresthe user to be authenticated. In order to do so, Cloud Gate 1104redirects browser 1102 to OAuth2 microservice 1110 to initiate OpenIDConnect login flow against the OAuth2 microservice 1110 (3-legged AZGrant flow with scopes=“openid profile”).

The request of browser 1102 traverses IDCS routing tier web service 1108and Cloud Gate 1104 and reaches OAuth2 microservice 1110. OAuth2microservice 1110 constructs the application context (i.e., metadatathat describes the application, e.g., identity of the connectingapplication, client ID, configuration, what the application can do,etc.), and redirects browser 1102 to SSO microservice 1112 to log in.

If the user has a valid SSO session, SSO microservice 1112 validates theexisting session without starting a login ceremony. If the user does nothave a valid SSO session (i.e., no session cookie exists), the SSOmicroservice 1112 initiates the user login ceremony in accordance withcustomer's login preferences (e.g., displaying a branded login page). Inorder to do so, the SSO microservice 1112 redirects browser 1102 to alogin application service 1114 implemented in JavaScript. Loginapplication service 1114 provides a login page in browser 1102. Browser1102 sends a REST POST to the SSO microservice 1112 including logincredentials. The SSO microservice 1112 generates an access token andsends it to Cloud Gate 1104 in a REST POST. Cloud Gate 1104 sends theauthentication information to Admin SCIM microservice 1116 to validatethe user's password. Admin SCIM microservice 1116 determines successfulauthentication and sends a corresponding message to SSO microservice1112.

In one embodiment, during the login ceremony, the login page does notdisplay a consent page, as “login” operation requires no furtherconsent. Instead, a privacy policy is stated on the login page,informing the user about certain profile attributes being exposed toapplications. During the login ceremony, the SSO microservice 1112respects customer's IDP preferences, and if configured, redirects to theIDP for authentication against the configured IDP.

Upon successful authentication or validation, SSO microservice 1112redirects browser 1102 back to OAuth2 microservice 1110 with the newlycreated/updated SSO host HTTP cookie (e.g., the cookie that is createdin the context of the host indicated by “HOSTURL”) containing the user'sauthentication token. OAuth2 microservice 1110 returns AZ Code (e.g., anOAuth concept) back to browser 1102 and redirects to Cloud Gate 1104.Browser 1102 sends AZ Code to Cloud Gate 1104, and Cloud Gate 1104 sendsa REST POST to OAuth2 microservice 1110 to request the access token andthe identity token. Both tokens are scoped to OAuth microservice 1110(indicated by the audience token claim). Cloud Gate 1104 receives thetokens from OAuth2 microservice 1110.

Cloud Gate 1104 uses the identity token to map the user's authenticatedidentity to its internal account representation, and it may save thismapping in its own HTTP cookie. Cloud Gate 1104 then redirects browser1102 to client 1106. Browser 1102 then reaches client 1106 and receivesa corresponding response from client 1106. From this point on, browser1102 can access the application (i.e., client 1106) seamlessly for aslong as the application's local cookie is valid. Once the local cookiebecomes invalid, the authentication process is repeated.

Cloud Gate 1104 further uses the access token received in a request toobtain “user info” from OAuth2 microservice 1110 or the SCIMmicroservice. The access token is sufficient to access the “userinfo”resource for the attributes allowed by the “profile” scope. It is alsosufficient to access “/me” resources via the SCIM microservice. In oneembodiment, by default, the received access token is only good for userprofile attributes that are allowed under the “profile” scope. Access toother profile attributes is authorized based on additional (optional)scopes submitted in the AZ grant login request issued by Cloud Gate1104.

When the user accesses another OAuth2 integrated connecting application,the same process repeats.

In one embodiment, the SSO integration architecture uses a similarOpenID Connect user authentication flow for browser-based user logouts.In one embodiment, a user with an existing application session accessesCloud Gate 1104 to initiate a logout. Alternatively, the user may haveinitiated the logout on the IDCS side. Cloud Gate 1104 terminates theapplication-specific user session, and initiates OAuth2 OpenID Provider(“OP”) logout request against OAuth2 microservice 1110. OAuth2microservice 1110 redirects to SSO microservice 1112 that kills theuser's host SSO cookie. SSO microservice 1112 initiates a set ofredirects (OAuth2 OP and SAML IDP) against known logout endpoints astracked in user's SSO cookie.

In one embodiment, if Cloud Gate 1104 uses SAML protocol to request userauthentication (e.g., login), a similar process starts between the SAMLmicroservice and SSO microservice 1112.

Cloud Cache

One embodiment provides a service/capability referred to as Cloud Cache.Cloud Cache is provided in IDCS to support communication withapplications that are LDAP based (e.g., email servers, calendar servers,some business applications, etc.) since IDCS does not communicateaccording to LDAP while such applications are configured to communicateonly based on LDAP. Typically, cloud directories are exposed via RESTAPIs and do not communicate according to the LDAP protocol. Generally,managing LDAP connections across corporate firewalls requires specialconfigurations that are difficult to set up and manage.

To support LDAP based applications, Cloud Cache translates LDAPcommunications to a protocol suitable for communication with a cloudsystem. Generally, an LDAP based application uses a database via LDAP.An application may be alternatively configured to use a database via adifferent protocol such as SQL. However, LDAP provides a hierarchicalrepresentation of resources in tree structures, while SQL representsdata as tables and fields. Accordingly, LDAP may be more desirable forsearching functionality, while SQL may be more desirable fortransactional functionality.

In one embodiment, services provided by IDCS may be used in an LDAPbased application to, for example, authenticate a user of theapplications (i.e., an identity service) or enforce a security policyfor the application (i.e., a security service). In one embodiment, theinterface with IDCS is through a firewall and based on HTTP (e.g.,REST). Typically, corporate firewalls do not allow access to internalLDAP communication even if the communication implements Secure SocketsLayer (“SSL”), and do not allow a TCP port to be exposed through thefirewall. However, Cloud Cache translates between LDAP and HTTP to allowLDAP based applications reach services provided by IDCS, and thefirewall will be open for HTTP.

Generally, an LDAP directory may be used in a line of business such asmarketing and development, and defines users, groups, works, etc. In oneexample, a marketing and development business may have differenttargeted customers, and for each customer, may have their ownapplications, users, groups, works, etc. Another example of a line ofbusiness that may run an LDAP cache directory is a wireless serviceprovider. In this case, each call made by a user of the wireless serviceprovider authenticates the user's device against the LDAP directory, andsome of the corresponding information in the LDAP directory may besynchronized with a billing system. In these examples, LDAP providesfunctionality to physically segregate content that is being searched atruntime.

In one example, a wireless service provider may handle its own identitymanagement services for their core business (e.g., regular calls), whileusing services provided by IDCS in support of a short term marketingcampaign. In this case, Cloud Cache “flattens” LDAP when it has a singleset of users and a single set of groups that it runs against the cloud.In one embodiment, any number of Cloud Caches may be implemented inIDCS.

Distributed Data Grid

In one embodiment, the cache cluster in IDCS is implemented based on adistributed data grid, as disclosed, for example, in U.S. Pat. Pub. No.2016/0092540, the disclosure of which is hereby incorporated byreference. A distributed data grid is a system in which a collection ofcomputer servers work together in one or more clusters to manageinformation and related operations, such as computations, within adistributed or clustered environment. A distributed data grid can beused to manage application objects and data that are shared across theservers. A distributed data grid provides low response time, highthroughput, predictable scalability, continuous availability, andinformation reliability. In particular examples, distributed data grids,such as, e.g., the Oracle Coherence data grid from Oracle Corp., storeinformation in-memory to achieve higher performance, and employredundancy in keeping copies of that information synchronized acrossmultiple servers, thus ensuring resiliency of the system and continuedavailability of the data in the event of failure of a server.

In one embodiment, IDCS implements a distributed data grid such asCoherence so that every microservice can request access to shared cacheobjects without getting blocked. Coherence is a proprietary Java-basedin-memory data grid, designed to have better reliability, scalability,and performance than traditional relational database management systems.Coherence provides a peer to peer (i.e., with no central manager),in-memory, distributed cache.

FIG. 12 illustrates an example of a distributed data grid 1200 whichstores data and provides data access to clients 1250 and implementsembodiments of the invention. A “data grid cluster”, or “distributeddata grid”, is a system comprising a plurality of computer servers(e.g., 1220 a, 1220 b, 1220 c, and 1220 d) which work together in one ormore clusters (e.g., 1200 a, 1200 b, 1200 c) to store and manageinformation and related operations, such as computations, within adistributed or clustered environment. While distributed data grid 1200is illustrated as comprising four servers 1220 a, 1220 b, 1220 c, 1220d, with five data nodes 1230 a, 1230 b, 1230 c, 1230 d, and 1230 e in acluster 1200 a, the distributed data grid 1200 may comprise any numberof clusters and any number of servers and/or nodes in each cluster. Inan embodiment, distributed data grid 1200 implements the presentinvention.

As illustrated in FIG. 12, a distributed data grid provides data storageand management capabilities by distributing data over a number ofservers (e.g., 1220 a, 1220 b, 1220 c, and 1220 d) working together.Each server of the data grid cluster may be a conventional computersystem such as, for example, a “commodity x86” server hardware platformwith one to two processor sockets and two to four CPU cores perprocessor socket. Each server (e.g., 1220 a, 1220 b, 1220 c, and 1220 d)is configured with one or more CPUs, Network Interface Cards (“NIC”),and memory including, for example, a minimum of 4 GB of RAM up to 64 GBof RAM or more. Server 1220 a is illustrated as having CPU 1222 a,Memory 1224 a, and NIC 1226 a (these elements are also present but notshown in the other Servers 1220 b, 1220 c, 1220 d). Optionally, eachserver may also be provided with flash memory (e.g., SSD 1228 a) toprovide spillover storage capacity. When provided, the SSD capacity ispreferably ten times the size of the RAM. The servers (e.g., 1220 a,1220 b, 1220 c, 1220 d) in a data grid cluster 1200 a are connectedusing high bandwidth NICs (e.g., PCI-X or PCIe) to a high-performancenetwork switch 1220 (for example, gigabit Ethernet or better).

A cluster 1200 a preferably contains a minimum of four physical serversto avoid the possibility of data loss during a failure, but a typicalinstallation has many more servers. Failover and failback are moreefficient the more servers that are present in each cluster and theimpact of a server failure on a cluster is lessened. To minimizecommunication time between servers, each data grid cluster is ideallyconfined to a single switch 1202 which provides single hop communicationbetween servers. A cluster may thus be limited by the number of ports onthe switch 1202. A typical cluster will therefore include between 4 and96 physical servers.

In most Wide Area Network (“WAN”) configurations of a distributed datagrid 1200, each data center in the WAN has independent, butinterconnected, data grid clusters (e.g., 1200 a, 1200 b, and 1200 c). AWAN may, for example, include many more clusters than shown in FIG. 12.Additionally, by using interconnected but independent clusters (e.g.,1200 a, 1200 b, 1200 c) and/or locating interconnected, but independent,clusters in data centers that are remote from one another, thedistributed data grid can secure data and service to clients 1250against simultaneous loss of all servers in one cluster caused by anatural disaster, fire, flooding, extended power loss, and the like.

One or more nodes (e.g., 1230 a, 1230 b, 1230 c, 1230 d and 1230 e)operate on each server (e.g., 1220 a, 1220 b, 1220 c, 1220 d) of acluster 1200 a. In a distributed data grid, the nodes may be, forexample, software applications, virtual machines, or the like, and theservers may comprise an operating system, hypervisor, or the like (notshown) on which the node operates. In an Oracle Coherence data grid,each node is a Java virtual machine (“JVM”). A number of JVMs/nodes maybe provided on each server depending on the CPU processing power andmemory available on the server. JVMs/nodes may be added, started,stopped, and deleted as required by the distributed data grid. JVMs thatrun Oracle Coherence automatically join and cluster when started.JVMs/nodes that join a cluster are called cluster members or clusternodes.

Architecture

Each client or server includes a bus or other communication mechanismfor communicating information, and a processor coupled to bus forprocessing information. The processor may be any type of general orspecific purpose processor. Each client or server may further include amemory for storing information and instructions to be executed byprocessor. The memory can be comprised of any combination of randomaccess memory (“RAM”), read only memory (“ROM”), static storage such asa magnetic or optical disk, or any other type of computer readablemedia. Each client or server may further include a communication device,such as a network interface card, to provide access to a network.Therefore, a user may interface with each client or server directly, orremotely through a network, or any other method.

Computer readable media may be any available media that can be accessedby processor and includes both volatile and non-volatile media,removable and non-removable media, and communication media.Communication media may include computer readable instructions, datastructures, program modules, or other data in a modulated data signalsuch as a carrier wave or other transport mechanism, and includes anyinformation delivery media.

The processor may further be coupled via bus to a display, such as aLiquid Crystal Display (“LCD”). A keyboard and a cursor control device,such as a computer mouse, may be further coupled to bus to enable a userto interface with each client or server.

In one embodiment, the memory stores software modules that providefunctionality when executed by the processor. The modules include anoperating system that provides operating system functionality eachclient or server. The modules may further include a cloud identitymanagement module for providing cloud identity management functionality,and all other functionality disclosed herein.

The clients may access a web service such as a cloud service. The webservice may be implemented on a WebLogic Server from Oracle Corp. in oneembodiment. In other embodiments, other implementations of a web servicecan be used. The web service accesses a database which stores clouddata.

IAM Functionality Example

In one embodiment, IAM functionality is implemented by software storedin memory or other computer readable or tangible medium, and executed bya processor.

A request is received for performing an identity management service. Inone embodiment, the request includes a call to an API that identifiesthe identity management service and a microservice configured to performthe identity management service. In one embodiment, the microservice isa self-contained module that can communicate with othermodules/microservices, and each microservice has an unnamed universalport that can be contacted by others. For example, in one embodiment, avariety of applications/services 602 may make HTTP calls to IDCS APIs touse IDCS microservices 614 as illustrated in FIG. 6. In one embodiment,a microservice is a runtime component/process.

In one embodiment, the request includes a URL. In one embodiment, themicroservice is identified in a prefix of the URL. In one embodiment, aresource portion of the URL identifies the API. In one embodiment, ahost portion of the URL identifies a tenancy of a resource related tothe request. For example, in a URL such as “host/microservice/resource”in the web environment of IDCS, a microservice is characterized byhaving a specific URL prefix, e.g., “host/oauth/v1” where the actualmicroservice is “oauth/v1”, and under “oauth/v1” there are multipleAPIs, e.g., an API to request tokens: “host/oauth/v1/token”, an API toauthenticate a user: “host/oauth/v1/authorize”, etc. That is, the URLimplements a microservice, and the resource portion of the URLimplements an API. Accordingly, multiple APIs are aggregated under thesame microservice. In one embodiment, the host portion of the URLidentifies a tenant (e.g.,https://tenant3.identity.oraclecloud.com:/oauth/v1/token”).

The request is then authenticated. In one embodiment, the request isauthenticated by a security gate such as Cloud Gate as described herein,for example, with reference to web routing tier 610 in FIG. 6 and/orcloud gate 702 in FIG. 7.

The microservice is then accessed based on the API, for example, asdescribed herein with reference to the IDCS “API platform” and accessingmicroservices in IDCS middle tier 614 in FIG. 6. In one embodiment,communicating with the microservice is configured through an unnameduniversal port of the microservice. In one embodiment, the unnameduniversal port of a microservice is a standard communication channelthat the microservice exposes by convention (e.g., as a conventionalHTTP port) and that allows any other module/microservice within the sameservice to talk to it. In one embodiment, the microservice provides oneor more capabilities by exposing one or more APIs. In one embodiment,communication with the microservice is implemented only through the oneor more APIs. That is, the microservice can be reached/contacted only bymaking calls to such APIs. In one embodiment, communication with themicroservice is configured according to a lightweight protocol. In oneembodiment, the lightweight protocol includes HTTP and REST. In oneembodiment, the request includes a call to a RESTful HTTP API.Accordingly, one embodiment provides dispatching functionality. EachHTTP request includes a URI and a verb. The embodiment parses theendpoint (host/service/resource) from the URI and combines it with theHTTP verb (e.g., POST, PUT, PATCH, or Delete) to dispatch (or invoke)the appropriate method of the appropriate module. This pattern is commonto REST and is supported by various packages (e.g., Jersey).

The identity management service is then performed by the microservice,for example, as described herein with reference to the IDCS “APIplatform” and accessing microservices in IDCS middle tier 614 in FIG. 6.In one embodiment, the microservice is stateless, horizontally scalable,and independently deployable. In one embodiment, each physicalimplementation of the microservice is configured to securely supportmultiple tenants. In one embodiment, the identity management serviceincludes a login service, an SSO service, a federation service, a tokenservice, a directory service, a provisioning service, or an RBACservice.

Declarative Third Party Identity Provider Integration for a Multi-TenantIdentity Cloud Service

A “Social login” or 3^(rd) party login is a form of sign-in/login wherea user uses social network services or other 3^(rd) party services suchas Facebook, Twitter or Google to login to a service/application (e.g.,IDCS). Social login services such as Facebook function as an identityprovider (“IP” or “IdP”) and the service that the user desires to accessacts as a service provider (“SP”) or relying party. If the user does nothave an account on the service, then depending on the service provider'simplementation, it can either ask the user to finish registration andcreate an account or just gather the user's salutation information anduse it to personalize the user experience. If the user is alreadyregistered, then it can map the user to an existing user based on anemail address or other identifier.

Specifically as related to IDCS disclosed above, and any other cloudproviders, the identity provider, also known as an identity assertionprovider, provides identifiers for users who want to interact with IDCSusing a website that is external to IDCS. The service provider is awebsite such as IDCS that hosts applications. A administrator can enablean identity provider and define one or more service providers. The userscan then access the applications hosted by the service providersdirectly from the identity provider.

For example, a website can allow users to login to IDCS with Googlecredentials. Google acts as the identity provider and IDCS functions asthe service provider. Google verifies that the user is an authorizeduser and returns information to IDCS (for example, the user name and theemail address of the user, if the email address differs from the username).

A user must be authenticated only once. For this example, the userobtains a security token. This security token is then validated byGoogle so that the user can access IDCS. This method is known asfederated single sign-on (“SSO”), where a single token for the user istrusted across multiple IT systems. The same token can be used toauthenticate the user against both the identity provider and the serviceprovider (for this example, Google and IDCS).

Embodiments of IDCS disclosed above have a need to integrate with thirdparty identity providers to support at least the followingfunctionalities: (1) Login Use Case: Allowing a login to IDCS using anexisting account with the third party identity providers (i.e., sociallogin); and (2) Provisioning Use Case: Automatic provisioning of useraccounts in third party identity domains. In the provisioning use case,the metadata will be used only in the process of obtaining the accesstoken from the third party provider.

Many of these 3^(rd) party identity providers support the OAuth standardspecification for authorizing access to the user data available withthem, but the OAuth implementation of each provider generally differsfrom each other. These differences include the following:

The name of the endpoints used for the Authorization Request, AccessToken Request and User Information Request;

The parameters/attributes supported by the HTTP Requests and HTTPResponses for these endpoints;

The mechanism for including the access token in the API call;

The format of the user profile data; and

Custom parameters that are not part of the OAuth protocol.

Due to these differences, one known solution used by IDCS and othermulti-tenant cloud providers is to provide a dedicated integration foreach of a selection of supported 3^(rd) party providers such as Google,Facebook, Microsoft, Linkedin, Twitter, GitHub, Instagram, etc. Withsocial login, once the user has logged in, IDCS finds the user with thesame email address. If the user is not found then it asks the user tocomplete registration. With known solutions, each 3^(rd) party provideris pre-configured so that IDCS merely needs a clientID and client secretfor an application created on the service provider to facilitate sociallogin.

However, there are problems with known social login solutions, includingthe following:

If a new 3^(rd) party provider is to be supported, it requires a fullcycle of code developing, testing and releasing the integration withthat provider.

Since new provider support required coding, it is relatively hard forcustomers and 3rd party integrators to develop and demonstrateintegration with new identity providers.

Since IDCS is a multi-tenant cloud service, a customer cannot be allowedto write code for the custom integration and deploy the code on sharedIDCS instance. Therefore, there is no self-service option available tocustomers to develop their custom integration with desired identityproviders, and they have no other options other than relying on themulti-tenant cloud provider to add support for their desired identityprovider.

In contrast, with known solutions, which require complex integrationcoding, embodiments provide a declarative mechanism for integrating withthe 3^(rd) party identity providers. This enables Identity DomainAdministrators, or a user with special privileges, to add support for anidentity provider by merely specifying the metadata for interacting withthe service endpoints exposed by the identity provider. The metadata isthen used by a declarative mechanism in embodiments of the invention toadd the new 3^(rd) party provider.

Embodiments allow metadata to define the providers to make themavailable. This “declarative” approach eliminates the need for codingand enables the process of adding new providers rapidly. Embodimentsfurther expose, for the definition of the metadata of global providers(for all tenants), a SCIM compliant REST endpoint (e.g.,{{idcs-oracle-url}}/admin/v1/SocialIdentityProviderMetadata).

Embodiments further define custom providers for customers. Since thisapproach does not require any coding, the customers can add providersand will not impose any issues related to 3rd party code in the clouddeployment. For the definition of the metadata by customers, embodimentsexpose a SCIM compliant REST endpoint (e.g.,{{tenant-url}}/admin/v1/CustomSocialIdentityProviderMetadata).

The metadata in embodiments includes the following that facilitatesintegration with a new 3^(rd) party identity provider:

The OAuth endpoints and the corresponding request and response headersand parameters. For example, the following metadata can be used for thetoken endpoint for GitHub:

 “tokenPhase”: {  “url”: “https://github.com/login/oauth/access_token”, “method”: “post” }, “tokenPhaseHeaders”: [  {   “value”:“application/json”,   “name”: “Accept”  },  {   “value”: “Basic$clientCredentials”,   “name”: “Authorization”  } ],“tokenPhaseParameters”: [  {   “value”:“$socialIdentityProvider.consumerKey”,   “name”: “client_id”  },  {  “value”: “$socialIdentityProvider.consumerSecret”,   “name”:“client_secret”  },  {   “value”: “$redirectUri”,   “name”:“redirect_uri”  },  {   “value”: “$authorizationCode”,   “name”: “code” },  {   “value”: “authorization_code”,   “name”: “grant_type”  } ],

Whether the identity provider will be used for social login or socialprovider provisioning or both.

What are the OAuth scope to be requested from the identity providers inthe social login and provisioning use cases, respectively. For example,the following is an example of scopes defined for GitHub:

“user user:email”

Mapping of user profile attributes with the IDCS user profileattributes. An example of user profile attribute mapping used for GitHubis as follows: “userInfoAttributeMappings”:

[  {   “idpAttribute”: “name”,   “idcsAttribute”: “given_name”  } ]

FIG. 13 illustrates a sequence diagram in accordance with embodiments ofthe invention. In FIG. 13, the elements include the user 1301 who can bean Identity Domain Administrator or an IDCS Administrator. An IdentityDomain Administrator can merely be a user with special privileges. Theelements further include Social Identity Provider Metadata Service 1302and SSO 1303. Metadata service 1302, SSO 1303 and Social Login Service1304 are implemented by microservices within IDCS. Social IdentityProvider 1305 is implemented by the 3^(rd) party identity provider suchas Facebook. Metadata service 1302 is a SCIM complaint REST endpoint inone embodiment.

At 1310, the user defines the metadata using the declarative frameworkdisclosed herein. The metadata in one embodiment is stored in theIdentity Cloud Service Database. The metadata is declarative in that theuser merely needs to specify what needs to be done rather than how it isdone. For example, the user merely needs to specify the token endpointof the social provider (i.e., Social Identity Provider Metadata Service1302) and the desired values of parameters (i.e., the endpoint requestand response parameters), but does not need to be concerned with how tothe connect to the token endpoint and process the token.

At 1311, the user initiates login using a social identity provider orother 3^(rd) party identity provider by sending a request via REST APIto SSO microservice 1303.

At 1312, SSO 1303 initiates logon to Social Login Service 1304. SocialLogin Service 1304 then at 1313 retrieves the stored metadata and usesthe metadata to build an authorization request.

An authorization phase at 1314-1316 results in an authorization code atSocial Login Service 1304 after user 1301 is authorized. Theauthorization code is a temporary code that the client will exchange foran access token. The code itself is obtained from the authorizationserver where the user gets a chance to see what the information theclient is requesting, and approve or deny the request. An access tokenphase at 1317-1319 uses the authorization code and the metadata toobtain an access token (e.g., a OAuth token).

A user profile phase at 1320-1322 sends a request with the access tokento the user info endpoint (i.e., the metadata) and uses the metadata toreturn user information security token claims about user 1301.

At 1323, the user information is used to request a user sessioncreation, and at 1324 the login is successful.

For the authorization phase 1314-16, if the URL for the redirect to idp1305 authorize endpoint is as per the default implementation, thefollowing methods need to be overridden:

Method Description protected String Returns the defaultgetDefaultAuthorizationURL( ) Authorization Endpoint URL for idp 1305.This value will used in case the social idp profile configured by thetenant admin does not specify the Authorization Endpoint URL. protectedString Returns the comma separated list of getDefaultLoginScopes( )scopes to be requested from OP for getting access to user's socialprofile. If not overridden, default is “openid”. Required only if theplugin has LOGIN capability. This value will used in case the social idpprofile configured by the tenant admin does not specify login scopes.protected String Returns the comma separated list ofgetDefaultProvisioningScopes( ) scopes to be requested from OP forgetting provisioning privileges. If not overridden, default is “”.Required only if the plugin has PROVISIONING capability. This value willused in case the social idp profile configured by the tenant admin doesnot specify the provisioning scopes. protected String This method can beused to add augmentAuthorizationURL(String additional query parametersto the authzURL, SocialIdentityProvider redirect url for Authorizationconfig, SocialCapability endpoint socialCapability)

The URL generated by default implementation is as follows:

<Authorization Endpoint URL for OP>?

client_id=<client id>&

response_type=code&

scope=<scopes>

redirect_un=<tenant base ud>/oauth2/v1/social/callback&

state=<auto generated by idcs>

If the URL for the redirect to OP Authorize endpoint is not exactly asper the default implementation, then the following method needs to beoverridden in embodiments:

Method Description protected String Returns the complete URLgetAuthorizationResponse(String state, for redirecting to idp 1305'sString returnURL, SocialIdentityProvider Authorization Endpoint. config,SocialCapability socialCapability)

For the access token phase 1317-19, if the interaction with idp 1305'stoken endpoint is as per the default implementation, the followingmethods need to be overridden:

Method Description public String Returns the URL for OP's TokengetDefaultAccesstokenUrl( ) Endpoint. This value will used in case thesocial idp profile configured by the tenant admin does not specify TokenEndpoint URL.

Interaction as per default implementation in embodiments is as follows:

Request:

POST <OP's Token Endpoint> HTTP/1.1Host: <OP's base url> Content-Type:application/x-www-form-urlencodedcode=<authorization code acquired inauthorize phase>& client_id=<client id>& client_secret=<client secret>&redirect_uri=<tenant base url>/oauth2/v1/social/callback&grant_type=authorization_codeResponse{“access_token”:“<accesstoken>”,“refresh_token”:“<refreshtoken>”,“expires_in”:3600}refresh_token may not be sent in the response in the login use case.

If the request sent to the idp 1305's Token endpoint is not exactly asper the default implementation, but the response is as per the defaultimplementation, then embodiments override the following method:

Method Description public String Returns the JSONgetAccessTokenResponse(SocialIdentityProvider response from the config,String returnURL, String code, Token endpoint Map<String, String> state)invocation as a String. throws SocialLoginException

If both request and response for the idp 1305's Token endpoint are notas per the default implementation, embodiments override the followingmethod

Method Description public SocialBaseResponse Returns the responsegetAccessToken(SocialBaseRequest request, from the Token endpointMap<String, String> state, String returnURL, invocation as aSocialIdentityProvider SocialBaseResponse config) throwsSocialLoginException object.

For the user profile access token phase 1320-22 If the interaction withidp 1305's User Info endpoint is as per the default implementation, thenembodiments override using the following method:

Method Description public String Returns the URL for OP's UserInfoEndpoint. getDefaultUserInfoUrl( ) This value will used in case thesocial idp profile configured by the tenant admin does not specifyUserInfo Endpoint URL.Sample Interaction as Per Default Implementation:Requesthttps://www.googleapis.com/oauth2/v3/userinfo?access_token=<access-token>ResponseHTTP/1.1 200 OKContent-Type: application/json

{  “sub”: “248289761001”,  “name”: “Jane Doe”,  “given_name”: “Jane”, “family_name”: “Doe”,  “preferred_username”: “j.doe”,  “email”:“janedoe@example.com”,  “picture”: “http://example.com/janedoe/me.jpg” }

If the interaction with the idp 1305's Userinfo endpoint is not as perthe default implementation, embodiments also override the followingmethod

Method Description public MapValue Returns the response fromgetUserProfileResponse(SocialBaseRequest the UserInfo endpoint request,Map<String, String> state, invocation as a MapValue. SocialLoginResponseaccessTokenResponse, The following SocialIdentityProvider config)standard keys are expected throws SocialLoginException to be present inthe MapValue: email: email address of the user given_name: First name ofthe user family_name: Last name of the user Hence if the responsereturned by the UserInfo endpoint has different keys for theseattributes, then you will be required to change the key names.

In embodiments, the 3^(rd) party identity provider metadata is in JSONformat conforming to a SCIM Compliant Schema disclosed below. Instead ofgenerating the JSON from scratch, the following samples can be used as astarting point. Expressions starting with $ refer to the parametervalues that are not constant. For example,

-   -   $socialIdentityProvider represents the corresponding        SocialIdentityProvider resource. For example,        $socialIdentityProvider.consumerKey refers to the client secret        configured in the tenant specific social identity provider        profile.    -   ${state} is the state generated by IDCS runtime while sending        the Authorize request 1314 to social idp 1305.    -   ${redirectUri} is the tenant specific callback URL generated by        the IDCS runtime.    -   ${scope} refers to:        -   In the login use-case, the scope string specified as value            of the “loginScopes” attribute.        -   In the provisioning use-case, the scope string specified as            value of the “provisioningScopes” attribute.    -   ${clientCredentials} is the standard base 64 encoded        representation of client ID and client secret as required in the        authorization header for Basic authentication scheme.    -   ${authorizationCode} refers to the authorization code received        with callback from the social idp.

The following is sample metadata for the login use case:

{ “type”: “SampleProviderForLogin”, “status”: “enabled”, “idAttribute”:“email”, “capabilities”: [ “login” ], “authorizePhase”: { “loginScopes”:“<scope string>”, “url”: “<Authorization endpoint>” },“authorizePhaseParameters”: [ { “value”:“${socialIdentityProvider.consumerKey}”, “name”: “client_id” }, {“value”: “code”, “name”: “response_type” }, { “value”: “${scope}”,“name”: “scope” }, { “value”: “${state}”, “name”: “state” }, { “value”:“${redirectUri}”, “name”: “redirect_uri” } ], “tokenPhase”: { “url”:“<Token endpoint>”, “method”: “<HTTP method for Token endpoint -get/post>” }, “tokenPhaseHeaders”: [ { “value”: “application/json”,“name”: “Accept” }, { “value”: “Basic ${clientCredentials}”, “name”:“Authorization” } ], “tokenPhaseParameters”: [ { “value”:“${socialIdentityProvider.consumerKey}”, “name”: “client_id” }, {“value”: “${socialIdentityProvider.consumerSecret}”, “name”:“client_secret” }, { “value”: “${redirectUri}”, “name”: “redirect_uri”}, { “value”: “${authorizationCode}”, “name”: “code” }, { “value”:“authorization_code”, “name”: “grant_type” } ], “userInfoPhase”: {“url”: “<UserInfo endpoint>”, “method”: “<HTTP method for UserInfoendpoint - get/post>” }, “userInfoPhaseHeaders”: [ { “value”: “*/*”,“name”: “Accept” }, { “value”: “token ${accessToken}”, “name”:“Authorization” } ], “userInfoPhaseParameters”: [ { “name”:“access_token”, “value”: “${accessToken}” } ],“userInfoAttributeMappings”: [ { “idpAttribute”: “firstname”,“idcsAttribute”: “given_name” }, { “idpAttribute”: “lastname”,“idcsAttribute”: “family_name” }, { “idpAttribute”: “email.primary”,“idcsAttribute”: “email” } ], “iconUrl”:“<icon url>”, “schemas”: [“urn:ietf:params:scim:schemas:oracle:idcs:SocialIdentityProviderMetadata” ] }

The following is sample metadata for the provisioning use case:

{ “type”: “SampleProviderForProvisioning”, “status”: “enabled”,“capabilities”: [ “provisioning” ], “authorizePhase”: { “loginScopes”:“<scope string>”, “url”: “<Authorization endpoint>” },“authorizePhaseParameters”: [ { “value”:“${socialIdentityProvider.consumerKey}”, “name”: “client_id” }, {“value”: “code”, “name”: “response_type” }, { “value”: “${scope}”,“name”: “scope” }, { “value”: “${state}”, “name”: “state” }, { “value”:“${redirectUri}”, “name”: “redirect_uri” } ], “tokenPhase”: { “url”:“<Token endpoint>”, “method”: “<HTTP method for Token endpoint -get/post>” }, “tokenPhaseHeaders”: [ { “value”: “application/json”,“name”: “Accept” }, { “value”: “Basic ${clientCredentials}”, “name”:“Authorization” } ], “tokenPhaseParameters”: [ { “value”:“${socialIdentityProvider.consumerKey}”, “name”: “client_id” }, {“value”: “${socialIdentityProvider.consumerSecret}”, “name”:“client_secret” }, { “value”: “${redirectUri}”, “name”: “redirect_uri”}, { “value”: “${authorizationCode}”, “name”: “code” }, { “value”:“authorization_code”, “name”: “grant_type” } ],“refreshTokenPhaseHeaders”: [ { “value”: “application/json”, “name”:“Accept” } ], “refreshTokenPhaseParameters”: [ { “value”:“${socialIdentityProvider.consumerKey}”, “name”: “client_id” }, {“value”: “${socialIdentityProvider.consumerSecret}”, “name”:“client_secret” }, { “value”: “${refreshToken}”, “name”: “refresh_token”} { “value”: “refresh_token”, “name”: “grant_type” } ], “iconUrl”:“<iconurl>”, “schemas”: [“urn:ietf:params:scim:schemas:oracle:idcs:SocialIdentityProviderMetadata” ] }

In contrast to creating custom code as required in known solutions,using the metadata can be accomplished by a user with special privilegesrather than a technical coder/programmer. Further, embodiments have theability to add support for new social identity providers in a runningsystem without any changes to the underlying software. This makes theprocess much faster. Using the declarative facility, the support for anew provider can be added in a few minutes, while the process ofdeveloping code and deploying is a time consuming process.

Further, because the Identity Cloud Service is a multi-tenant service,due to security concerns, a user cannot be allowed to write code for thecustom integration and deploy the code on shared IDCS instances. Thisproblem is solved by embodiments of the invention which does allow theuser to define the metadata but not deploy custom code.

The defined metadata will differ from 3^(rd) party identity provider toprovider. However, the metadata, because of its declarative nature, issubstantially easier to generate as compared to custom code. The user isjust specifying what needs to be done rather than how it is to be done.For example, the user just needs to specify the token endpoint of thesocial provider and the desired values of parameters, but does not needto worry about how to connect to the token endpoint and process thetoken.

As disclosed, embodiments use declarative metadata, defined and storedby a user, to facilitate 3^(rd) party identity providers to providelogin functionality for a multi-tenant cloud service. A SCIM compliantREST endpoint is exposed that retrieves the metadata at the direction ofthe login services and 3^(rd) party identity provider.

Several embodiments are specifically illustrated and/or describedherein. However, it will be appreciated that modifications andvariations of the disclosed embodiments are covered by the aboveteachings and within the purview of the appended claims withoutdeparting from the spirit and intended scope of the invention.

What is claimed is:
 1. A method of providing login to a user using athird party identity provider for a multi-tenant identity cloud service,the method comprising: receiving declarative metadata comprising anidentity of a token endpoint corresponding to the third party identityprovider and corresponding parameter values, the user having credentialsthat allow the user to login to the third party identity provider;storing the declarative metadata in a database; receiving a request fora login to the multi-tenant identity cloud service using the third partyidentity provider, the request including the credentials; retrieving themetadata and building an authorization request; sending theauthorization request including the credentials to the third partyidentity provider and in response receiving an authorization code;retrieving the metadata and building a token request using theauthorization code; and sending the token request to the third partyidentity provider and in response receiving an access token.
 2. Themethod of claim 1, further comprising: retrieving the metadata andbuilding a user-info request using the access token; receiving userinformation based on the user-info request and receive a request tocreate a user session; successfully implementing the login of the userto the multi-tenant identity cloud service.
 3. The method of claim 1,wherein the access token comprises a OAuth token.
 4. The method of claim1, the declarative metadata further comprising a scope of the tokenrequest.
 5. The method of claim 1, the declarative metadata furthercomprising a mapping of user profile attributes of the third partyidentity provider with user profile attributes of the multi-tenantidentity cloud service.
 6. The method of claim 1, wherein retrieving themetadata comprises exposing a System for Cross-domain IdentityManagement (SCIM) Representational State Transfer (REST) endpoint. 7.The method of claim 1, wherein the metadata is in a JavaScript ObjectNotation (JSON) format.
 8. The method of claim 1, wherein thedeclarative metadata is generated by the user of the multi-tenantidentity cloud service.
 9. A non-transitory computer-readable mediumhaving instructions stored thereon, when executed by a processor, causethe processor to provide login functionality to a user using a thirdparty identity provider for a multi-tenant identity cloud service, thelogin functionality comprising: receiving declarative metadatacomprising an identity of a token endpoint corresponding to the thirdparty identity provider and corresponding parameter values, the userhaving credentials that allow the user to login to the third partyidentity provider; storing the declarative metadata in a database;receiving a request for a login to the multi-tenant identity cloudservice using the third party identity provider, the request includingthe credentials; retrieving the metadata and building an authorizationrequest; sending the authorization request including the credentials tothe third party identity provider and in response receiving anauthorization code; retrieving the metadata and building a token requestusing the authorization code; and sending the token request to the thirdparty identity provider and in response receiving an access token. 10.The computer-readable medium of claim 9, the login functionality furthercomprising: retrieving the metadata and building a user-info requestusing the access token; receiving user information based on theuser-info request and receive a request to create a user session;successfully implementing the login of the user to the multi-tenantidentity cloud service.
 11. The computer-readable medium of claim 9,wherein the access token comprises a OAuth token.
 12. Thecomputer-readable medium of claim 9, the declarative metadata furthercomprising a scope of the token request.
 13. The computer-readablemedium of claim 9, the declarative metadata further comprising a mappingof user profile attributes of the third party identity provider withuser profile attributes of the multi-tenant identity cloud service. 14.The computer-readable medium of claim 9, wherein retrieving the metadatacomprises exposing a System for Cross-domain Identity Management (SCIM)Representational State Transfer (REST) endpoint.
 15. Thecomputer-readable medium of claim 9, wherein the metadata is in aJavaScript Object Notation (JSON) format.
 16. The computer-readablemedium of claim 9, wherein the declarative metadata is generated by theuser of the multi-tenant identity cloud service.
 17. A multi-tenantcloud system for providing login to a user using a third party identityprovider for a multi-tenant identity cloud service, the systemcomprising: one or more hardware processers configured to provide loginto a user using a third party identity provider, the provide logincomprising: receiving declarative metadata comprising an identity of atoken endpoint corresponding to the third party identity provider andcorresponding parameter values, the user having credentials that avowthe user to login to the third party identity provider; storing thedeclarative metadata in a database; receiving a request for a login tothe multi-tenant identity cloud service using the third party identityprovider, the request including the credentials; retrieving the metadataand building an authorization request; sending the authorization requestincluding the credentials to the third party identity provider and inresponse receiving an authorization code; retrieving the metadata andbuilding a token request using the authorization code; and sending thetoken request to the third party identity provider and in responsereceiving an access token.
 18. The multi-tenant cloud system of claim17, the provide login further comprising: retrieving the metadata andbuilding a user-info request using the access token; receiving userinformation based on the user-info request and receive a request tocreate a user session; successfully implementing the login of the userto the multi-tenant identity cloud service.
 19. The multi-tenant cloudsystem of claim 17, wherein the access token comprises a OAuth token.20. The multi-tenant cloud system of claim 17, the declarative metadatafurther comprising a scope of the token request.